You need to enable JavaScript to run this app. Jenkins使用dependency-check-cli扫描jar包报Sonatype OSS Index SSL握手错误
优惠活动
大模型
产品
解决方案
定价
更多

Jenkins使用dependency-check-cli扫描jar包报Sonatype OSS Index SSL握手错误

故障根因

该错误本质是Jenkins运行Dependency Check时使用的JRE信任库中没有ossindex.sonatype.org的有效证书链,你之前导入证书未生效,大概率是导入的JRE路径和Jenkins实际使用的JRE路径不匹配、或只导入了站点叶子证书未导入完整证书链导致。

修复步骤
  • 第一步:确认Jenkins实际使用的JDK路径
    登录Jenkins控制台,访问「系统管理」->「系统信息」,找到java.home属性对应的路径,这才是Jenkins运行时实际调用的JRE路径,不要使用系统默认配置的JDK路径,多数情况下Jenkins会配置单独的JDK版本。
  • 第二步:导出完整证书链
    不要仅导出站点的单张叶子证书,要导出完整的根证书+中级证书链,执行以下命令将完整证书链保存到ossindex.crt文件:
    openssl s_client -showcerts -connect ossindex.sonatype.org:443 < /dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > ossindex.crt
    
  • 第三步:导入证书到对应JRE信任库
    用第一步拿到的java.home路径替换下方命令中的{JAVA_HOME_PATH},执行导入操作,cacerts默认密码为changeit:
    # 如果之前导入过同别名证书,先执行删除命令
    keytool -delete -alias ossindex -keystore {JAVA_HOME_PATH}/jre/lib/security/cacerts -storepass changeit
    # 导入新证书
    keytool -importcert -file ossindex.crt -alias ossindex -keystore {JAVA_HOME_PATH}/jre/lib/security/cacerts -storepass changeit
    
    导入时提示是否信任证书,输入yes回车确认即可。

注意:如果Jenkins所在服务器通过公司代理访问外网,多数公司代理会对HTTPS请求做证书替换,这种情况需要将代理的自签名根证书一同导入到JRE信任库中,否则依然会报证书校验错误。

  • 第四步:重启Jenkins服务生效
    证书导入完成后必须重启Jenkins进程,新的信任库配置才会被加载。
  • (可选)临时规避方案
    如果你不需要使用Sonatype OSS Index的分析能力,可以直接关闭该分析器跳过证书校验:
    命令行调用时添加启动参数:
    --disableOssIndex
    
    使用Jenkins插件的话,在Dependency Check构建步骤的高级配置里,勾选「禁用OSS Index分析器」选项即可。
验证方法

重启后重新执行构建任务,查看日志中是否还有SSLHandshakeException报错,正常情况下Sonatype OSS Index Analyzer可正常执行,不会抛出构建失败错误。

内容的提问来源于stack exchange,提问作者Ankit Patra

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 00:06:04