解决 Maven 的 unable to find valid certification path to requested target 错误
今天我在从公司的 Maven 私库上下载依赖时,Maven 报出了 unable to find valid certification path to requested target
的问题,经查询是因为没有将私库使用的自签名证书导入到 Java 的 keystore。这里写一下我的两个解决方案,方便发生了同样问题的人参考。
让 Maven 忽略证书错误
因为在默认情况下,自签名证书是不受信任的,那么我们只要让 Maven 忽略证书错误,就可以解决这个问题了。
我们可以在.bashrc
或.zshrc
(或者其他位置,看你用哪个 shell 了)里面加入如下语句:
1 | export MAVEN_OPTS='-Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true -Djsse.enableSNIExtension=false' |
或者,也可以在 ~/.mavenrc
中配置这个参数:
1 | MAVEN_OPTS="-Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true -Djsse.enableSNIExtension=false" |
导入证书到 keystore
首先使用这个命令得到网站上面的证书:
1 | # 注意将mavenrepository.mycompany.com替换成实际的地址 |
在输出中可以看到类似这样的证书信息:
1 | s:/C=US/ST=North Carolina/L=Raleigh/O=Red Hat, Inc./OU=Red Hat Network/CN=Entitlement Master CA/emailAddress=ca-support@redhat.com |
我们要在这里面寻找 issuer(i:)
和 subject(s:)
相同的证书,这个就是我们要导出的根证书。找到之后,保存证书的哈希(即以 —–BEGIN CERTIFICATE—–
开始,以 —–END CERTIFICATE—–
结束的这部分内容)到一个文件中,比如 root.crt
。
接下来,我们需要使用 keytool
把这个证书导入到 Java 的 keystore 中,命令如下:
1 | sudo keytool \ |
执行后 keytool 会询问是否信任这个证书,输入 yes
来信任。
导入完成后,Maven 就可以从这个私库下载依赖了。如果你使用 IDEA 的话,那么可能需要重新启动一下 IDEA 才会使新的 keystore 生效。
[^1]: How to resolve “unable to find valid certification path to requested target” error? - JFrog
[^2]: How to tell Maven to disregard SSL errors (and trusting all certs)?