本地授权服务(license-local)常见问题

license-1.6及以上版本：http://LICENSE_LOCAL_IP:8081/api/license/list

license-1.6以下或者兼容1.5模式部署的license版本：http://LICENSE_LOCAL_IP:8081/api/license-registration/activation-status

license-1.6及以上版本：http://LICENSE_LOCAL_IP:8081/api/license/nodeInfo

license-1.6以下或者兼容1.5模式部署的license版本： http://LICENSE_LOCAL_IP:8081/api/server/nodeInfo

升级jdk版本到8u162之上。

原因是低版本jdk不支持512位长度java安全相关算法：https://stackoverflow.com/questions/6481627/java-security-illegal-key-size-or-default-parameters

-Dhvisions.license.local.server=https://LICENSE_LOCAL_IP:9835

找到license-local的目录，把keys下license.db 删除掉， license-local就可以启动。
重新授权

新版本修复了这个问题，也可升级到license-local-1.0.8以上版本

比如这个wms-service应用，是项目上新加的应用，不需要接入授权，但是返回了601，然后跳转到了授权页面。这种项目误引入了hvisions-license-plugin这个jar导致的（可能是间接引入的），解决办法就是把这个jar exclude掉。hvisions-license-plugin 的坐标：

<dependency>
    <groupId>com.hvisions</groupId>
    <artifactId>hvisions-license-plugin</artifactId>
</dependency>

这个一般是配置的连接CAS前端地址错误。可以检查 /etc/systemd/system/license.service 中 cas前端地址的配置： -Dcas.auth.url=http://CAS-FE:8060 或者增加配置-Dcas.auth.enable=false直接关闭cas权限校验。调整之后，需要重启license-local生效。

# 停止服务
systemctl stop license.service
# 查看license服务状态，确认服务已经停止
systemctl status license.service
# 非必需， 如果修改了/etc/systemd/system/license.service 文件则需要reload一下配置
systemctl daemon-reload
# 启动服务，立即启动
systemctl start license.service

# 查看license服务状态，确认服务已经拉起来
systemctl status license.service


curl -X 'GET' \
  'http://10.10.32.34:8081/api/fingerprint/v2/supported?path=keys%2Flicense.db' \
  -H 'accept: */*'

会返回true和false，接口在license-local 1.0.8之后才有，1.0.8 默认是开启了v2版本指纹，如果不支持，可能是以下两种情况：

1.v2 版本指纹被禁用

2.license-local运行在docker内部

在license-local-1.0.8版本之后，指纹信息做过一次调整，默认会启用。升级过程中，如果版本v2运行出错，可以通过 -Dlicense.fingerprint.v2.enabled=false 禁用。

2025-08-25

本地授权服务(license-local)常见问题

1. 怎么通过接口查看授权有效期

2. 怎么查看连接节点情况

3. License组件报java.security.InvalidKeyException: Illegal Key Size

4. 如何配置plugin连接license-local的地址

5. 授权文件加载失败，License-local无法启动

6. 项目自建应用访问返回601

7. SSOFilter中OkHttps客户端报错

8. Linux环境下调整license服务配置后重启服务

9.查看是否启用v2版本的指纹

10.禁用v2版本的指纹

本页目录