浏览器打开正常,curl也能拿到200,换Java的RestTemplate或者HttpURLConnection调同一个HTTPS地址就抛异常,堆栈最里层是sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。这不是网络不通,是Java压根不认服务端证书链顶上那个根CA。Java有自己的信任库cacerts,跟操作系统的证书池是两套,往/etc/ssl/certs里塞证书对它没用。之前接手过一个对接内网接口的服务,运维把私有CA装进了系统证书目录,Java这边照样报错,白折腾半天。
先把报错链读明白
完整堆栈一般三层:最外层javax.net.ssl.SSLHandshakeException,中间是sun.security.validator.ValidatorException: PKIX path building failed,最里层是SunCertPathBuilderException。PKIX是证书链校验的算法名,building failed说的是从服务端证书往回找签发者,在cacerts里没找到可信锚点。触发它的就三类:服务端用了自签证书、内网私有CA签的证书、或者服务端只发了叶子证书没发中间证书。浏览器遇到缺中间证书会自己去拉,Java默认不做这件事。
同是SSLHandshakeException,另外几种别混进来:CertificateExpiredException是证书过期,No subject alternative names或者No name matching是证书里的域名跟访问的域名对不上,Received fatal alert: handshake_failure多半是TLS协议版本或密码套件谈不拢。只有unable to find valid certification path这一句指向信任库缺证书。实测把-Dhttps.protocols=TLSv1.2加到启动参数里,对PKIX这类报错一点用没有,改的是协议不是信任锚。
确认到底跑的是哪个JDK
这一步最容易漏。一台机器上装三四个JDK很常见,导入证书导到了A的cacerts,应用跑的却是B。
java -XshowSettings:all -version 2>&1 | grep java.home echo $JAVA_HOME readlink -f $(which java) find /usr/lib/jvm -name cacerts 2>/dev/null
Java 9之后JRE和JDK合并,cacerts在$JAVA_HOME/lib/security/cacerts;Java 8及更早是$JAVA_HOME/jre/lib/security/cacerts。默认密码changeit,Debian和Ubuntu用ca-certificates-java托管时可能是changeme,/etc/ssl/certs/java/cacerts往往是符号链接,跑一次update-ca-certificates就会把手工import的条目冲掉。IDE自带的JetBrains Runtime、Maven用的JAVA_HOME、systemd服务里Environment写的路径、容器镜像里的/opt/java/openjdk,各是各的,先对上号再动手。见过最折腾的一次是证书续期后全量告警,查下来是三个服务分别读了三份不同的cacerts。
清单命令用keytool -list -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit,加-v能看到证书指纹和有效期,想确认某个别名在不在就接grep。Java 9起默认密钥库类型从JKS换成PKCS12,老脚本里写死-storetype JKS,碰到新格式会弹警告甚至报Keystore was tampered with, or password was incorrect,其实是密码或格式没对上,不是文件坏了。
取证书链,数清楚服务端发了几张
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null keytool -printcert -sslserver api.example.com:443
数输出里-----BEGIN CERTIFICATE-----的块数:只有1块说明服务端只发了叶子,2块以上说明还带了中间证书,末尾那张通常是根或者签发它的中间CA。keytool -printcert -sslserver一行就能把链打出来,看Issuer和Subject对不对得上。如果服务端漏配了中间证书,正确做法是去nginx或Apache上把fullchain补齐,让所有客户端都拿到完整链,挨个给Java导证书是治标。OpenSSL 1.1.1、3.0.13、3.5.0,这三个版本跑上面那条命令输出格式基本一致。
真要往信任库里加,优先导根CA或中间CA,别导叶子证书。叶子一续期指纹就变了,到时又是一轮报错。企业内网那种TLS拦截设备换发的证书,找运维要它的私有根CA,比一张张导站点证书省事。
导入cacerts与独立trustStore两条路
keytool -importcert -alias internal-ca -file internal-ca.crt -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit -noprompt keytool -list -v -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit -alias internal-ca keytool -delete -alias internal-ca -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit
-importcert和老写法-import等价,-noprompt省掉Trust this certificate?那句交互。改完必须重启应用,TrustManager在SSLContext初始化时把cacerts读进内存缓存起来,运行中间换文件不生效,现场遇到过改完cacerts没重启、盯着日志等了半小时的。
容器里JDK目录只读、或者不想动全局文件,就复制一份cacerts出来单独导,再用三个启动参数指过去:
cp "$JAVA_HOME/lib/security/cacerts" /opt/app/truststore.p12 java -Djavax.net.ssl.trustStore=/opt/app/truststore.p12 -Djavax.net.ssl.trustStorePassword=changeit -Djavax.net.ssl.trustStoreType=PKCS12 -jar app.jar
这三个参数得放在JVM启动命令行里。代码里用System.setProperty设也行,但必须在进程第一次建立HTTPS连接之前,SSLContext已经初始化完再设就晚了。别图省事做全局设置,同进程里别的HTTP客户端跟着受影响。
握手日志能直接看出缺哪张
加-Djavax.net.debug=ssl:handshake,或者ssl,handshake,certpath,日志里会打出trustStore is:指向哪个文件、adding as trusted cert列了哪些别名,以及PKIXValidator找issuer时在哪一步断掉。TLS 1.2、1.3,两代协议下这段日志格式差别不大。要是日志显示信任库压根没读到刚改的那个路径,回到前面JDK那一步重新对一遍。
Spring Boot的RestTemplate、OkHttp、Apache HttpClient,默认都走JVM那套SSLContext,换客户端库绕不过PKIX校验。网上那种自定义TrustManager信任所有证书的写法,测试环境临时跑跑就算了,放到生产等于把TLS校验整段关掉。
1、报错带unable to find valid certification path,先按服务端自签、私有CA、缺中间证书三条排查,别去动协议版本。
2、导证书前先确认应用实际用的JDK和cacerts路径,多份JDK是这类问题反复出现的常见原因。
3、导根CA或中间CA,改完重启;容器或共享JDK走独立trustStore,三个javax.net.ssl参数写在启动命令行。
上面涉及的路径、默认密码和版本核对到2026年11月,OpenJDK 11.0.24、17.0.12、21.0.4,以及Java 8、Java 9之后的目录结构各不相同,动手前用java -XshowSettings:all -version把java.home打出来最稳。