uc安装问题

1、安装包版本 / 前缀名称不匹配（最高概率）

UC5.0 Matrix 后台会解析 zip 包内部 manifest 清单，不是只看文件名和 md5。

• RES 包文件名规范：NSM_RES_E7xxx_x86.zip；PERF 包：NSM_PERF_E7xxx_x86.zip；E 后面版本号必须完全一致。
• 错误场景：上传了大整合包、旧版本包、混淆了 UC4/UC5 包、把压缩包嵌套（zip 里面还有 zip）。

md5 只是校验文件完整性，md5 正确 ≠ 包内 manifest 清单正确，版本匹配。

2、上传后后台未完成包解析（前台页面看不到）

上传只是把文件丢进存储目录，后台需要自动解析 zip 内的清单文件，解析成功才会在下拉选项加载。 目录查看：

文件存在，但状态为未解析，前端下拉就无匹配数据。

• 修复：在安装包管理页面，选中 RES 包，点【重新解析】；或者后台重启 matrix-install 服务，重新加载包清单。

3、依赖基础底座包缺失

NSM 组件依赖 BMP 公共底座包（BMP_Common、BMP_UCP_BasePlat），如果底座包没有上传解析，NSM RES/PERF 组件即使包上传成功，向导下拉无法选择。

页面上方 ITOM 系列组件全部灰色 “请选择”，大概率是 BMP 底座包缺失 / 未解析。

4、架构不匹配（x86/arm 包混淆）

当前部署集群是 x86 架构，上传 ARM 版本 RES 包，md5 可以正常校验，但是 manifest 识别架构不匹配，下拉不展示。

5、浏览器缓存问题

页面缓存，没有拉取最新组件列表。

• 操作：清空浏览器缓存，无痕模式重新登录 Matrix 部署页面。

分步排查操作

1. 登录 Matrix 后台，查看已上传包清单 + 解析状态 进入【安装包管理】页面，确认： ✅ 是否存在 NSM_RES_E7xxxx_x86.zip、NSM_PERF_E7xxxx_x86.zip ✅ RES 与 PERF 版本号完全一致 ✅ 包状态是【解析成功】；如果是解析失败，查看页面解析日志（manifest 读取失败）
2. 核对 BMP 底座包：BMP_Common、BMP_UCP_BasePlat 必须上传并解析成功，NSM 强依赖底座。
3. 包解析失败处理： 选中 RES 包 → 点击【重新解析】；解析失败看日志：zip 包内部文件损坏、manifest.json 缺失（压缩包不全，md5 校验也可能显示正常）。
4. 版本不一致：更换同版本配套 NSM_RES、NSM_PERF。
5. 前端验证：无痕浏览器打开部署向导，再打开 RES 下拉。

常见踩坑

❌ 把整套打包的压缩包上传，不是单独上传每个组件 zip 包；UC5.0 要求每个组件独立 zip 包上传，不能嵌套压缩。 ❌ md5 校验通过就代表包可用：md5 只校验文件字节完整性，不校验内部 manifest 清单、版本、架构。 ❌ RES 和 PERF 版本号不一致：哪怕差一个小版本号，PERF 下拉同样无匹配。

一句话总结：优先进【安装包管理】看 RES 包解析状态和版本号，同时确认 BMP 底座包已上传解析；RES 和 PERF 版本号必须一模一样；包需要单独 zip，不能嵌套压缩。