License Manager

中文

English

中文

English

Appearance

常见问题排查 ​

本页按问题现象组织，用于开发、测试、交付和售后快速定位授权接入问题。

授权码不存在 ​

现象

激活接口返回授权码不存在，或 HTTP 状态码为 404。

可能原因

  • 授权码输入错误
  • 授权码来自另一个环境
  • 客户端 API 地址配置错误
  • 授权码已被删除

如何确认

  1. 核对客户端配置的 API 地址。
  2. 在管理后台查询授权码是否存在。
  3. 确认授权码是否属于当前租户或当前环境。

解决方法

  • 重新复制授权码。
  • 确认使用的是测试授权、生产授权，还是错误的平台地址。
  • 重新生成测试授权码。

授权码已过期 ​

现象

激活失败，提示授权码过期或授权状态冲突。

可能原因

  • 当前时间已经超过授权结束时间
  • 试用授权已到期
  • 授权有效期策略配置不符合预期

如何确认

  1. 查看授权码的开始时间和结束时间。
  2. 检查客户端机器时间是否明显异常。

解决方法

  • 续期授权。
  • 重新生成授权码。
  • 校准客户端系统时间。

授权码被锁定 ​

现象

授权码存在，但激活时提示不可用或状态冲突。

可能原因

  • 管理员手动锁定授权码
  • 风控或售后流程要求暂停使用

如何确认

  1. 在管理后台查看授权码状态。
  2. 查看操作记录或审计日志。

解决方法

  • 由管理员解锁。
  • 如果是违规使用，按业务规则处理。

激活次数已满 ​

现象

新设备激活失败，但旧设备仍可使用。

可能原因

  • 当前授权码已达到最大激活设备数
  • 旧设备未解绑
  • 测试环境反复激活占用了设备额度

如何确认

  1. 查看授权码最大激活数。
  2. 查看已绑定设备列表。
  3. 对比当前设备硬件指纹。

解决方法

  • 解绑不再使用的设备。
  • 扩容授权设备数。
  • 使用新的测试授权码。

设备指纹不一致 ​

现象

本地许可证存在，但客户端提示设备不匹配。

可能原因

  • 客户更换了网卡、主板或关键硬件
  • 虚拟机克隆导致设备信息变化
  • 客户端升级后指纹算法改变
  • 指纹字段顺序或规范化规则变化

如何确认

  1. 输出当前硬件指纹。
  2. 对比许可证中绑定的硬件指纹。
  3. 检查最近是否升级客户端或更换硬件。

解决方法

  • 保持指纹算法稳定。
  • 走换机或解绑流程。
  • 离线场景重新签发许可证。

签名验证失败 ​

现象

许可证文件存在，但本地验签失败。

可能原因

  • license_file 文件损坏
  • 当前产品公钥与许可证不匹配或本地公钥缺失
  • 验签前对 data 做了重新序列化
  • 客户端使用了错误的签名算法

如何确认

  1. 确认当前公钥与许可证属于同一产品：在线首次获取检查同次响应，心跳或启动检查本地配对数据，离线检查同批交付物。
  2. 检查许可证文件是否被截断或改写。
  3. 确认验签时使用原始 data 字符串。

解决方法

  • 在线客户端重新激活或按指纹恢复，并在完整校验后配对保存响应中的许可证和产品公钥。
  • 心跳新许可证校验失败时保留旧许可证与公钥；离线环境重新取得成对交付物。
  • 不要手工编辑许可证文件。
  • 按 本地许可证校验 的顺序处理。

许可证文件损坏 ​

现象

许可证无法 Base64 解码，或解析 JSON 失败。

可能原因

  • 文件写入未完成
  • 文件被用户手工修改
  • 存储路径权限不足
  • 复制离线许可证时内容缺失

如何确认

  1. 检查许可证文件大小是否异常。
  2. 检查写入目录权限。
  3. 重新复制许可证内容并比较长度。

解决方法

  • 重新激活或重新导入许可证。
  • 使用稳定的本地存储路径。
  • 写入文件时使用原子替换策略。

客户端时间异常 ​

现象

授权明明未到期，但客户端提示已过期；或过期授权仍被放行。

可能原因

  • 客户端系统时间错误
  • 时区处理不一致
  • 用户手动修改系统时间

如何确认

  1. 查看客户端本机时间。
  2. 对比许可证 start_date 和 end_date。
  3. 检查日志中的时区信息。

解决方法

  • 提示用户校准系统时间。
  • 客户端统一使用明确时区处理。
  • 高价值场景结合心跳或服务端时间校验。

网络不可达 ​

现象

在线激活或心跳失败，提示连接超时或服务不可达。

可能原因

  • 客户端无法访问 License Manager
  • API 地址配置错误
  • 防火墙或代理阻断
  • 服务端未启动

如何确认

  1. 在客户端机器访问 API 地址。
  2. 检查 DNS、代理和防火墙。
  3. 检查 License Manager 服务健康状态。

解决方法

  • 修正 API 地址。
  • 配置网络白名单。
  • 已有有效本地许可证时，按混合模式策略继续运行。

API Key 无效 ​

现象

调用需要鉴权的接口失败，提示未认证或凭证无效。

可能原因

  • API Key 输入错误
  • API Key 已禁用或过期
  • IP 白名单不匹配
  • 调用了不需要或不支持 API Key 的接口

如何确认

  1. 查看 API Key 状态。
  2. 确认请求来源 IP。
  3. 确认接口鉴权方式。

解决方法

  • 重新生成 API Key。
  • 调整 IP 白名单。
  • 按接口文档使用正确鉴权方式。