问题说明
本文适用于 HCI 旗舰版安装、升级或授权变更后，出现授权注册失败或 UKey 信息无法识别的场景。
现象
- 安装或注册授权时出现
register license error、error code: 500等报错。 - UKey 已接入，但授权页面未显示预期授权信息。
- 升级后 UKey 识别异常，或授权状态与变更前不一致。
适用环境
- 产品：HCI 旗舰版。
- 版本：4.x、5.x。具体版本配套关系以当前交付版本的授权说明为准。
- 涉及对象：ZStone、授权服务、管理节点和 UKey。
可能原因
- 当前授权文件、请求码或交付版本与环境不匹配。
- 管理节点服务异常，或安装、升级未完整完成。
- 当前版本不满足对应授权能力的依赖要求。
- 管理节点间授权状态未完成同步，或 UKey 识别状态异常。
排查步骤
- 记录当前 HCI 旗舰版、ZStone 和配套 Cloud 的版本，以及问题发生在安装、升级、授权上传还是 UKey 接入后。
- 核对授权文件适用的产品、版本、有效期和授权类型是否与当前环境一致。
- 确认管理平台可正常访问，管理节点服务无持续异常，并记录报错原文和发生时间。
- UKey 场景下，确认 UKey 已正确接入；如为双管理节点，记录两侧显示的授权状态是否一致。
- 收集相关安装、升级或授权操作日志。不要自行删除授权记录、覆盖授权文件或重置授权标识。
补充信息
以下情况建议联系官方技术支持确认后继续处理：
- 授权状态与请求码、交付信息不一致。
- 双管理节点授权信息不一致。
- 需要修复授权注册标识、授权文件或数据库记录。
- 升级后 UKey 仍无法识别。
提交支持请求时请提供：版本信息、部署形态、问题时间、报错原文、授权状态截图及已执行操作；不要提交密码、私钥或完整授权文件。