跳到主要内容
Tomcat

GeoTrust SSL 证书 Tomcat 安装部署教程(2026 版):PFX/JKS 配置、证书链排错与验证

GeoTrust 是 DigiCert 旗下中端品牌,OV 审核稳定,通常比主品牌低约 40%,适合预算有限但需要组织验证的企业。把 GeoTrust SSL 证书部署到 Tomcat,关键不是把文件拖进目录,而是让 Connector 加载包含完整证书链的 PFX/JKS,并让 Java、curl、小程序与浏览器看到同一条可信链。公开信任 TLS 证书自 2026-03-15 起最长有效期已缩短为 200 天(此前为 398 天),Let’s Encrypt 默认仍为 90 天,部署与续期节奏要按新规规划。

1. 问题背景与根因:为什么浏览器正常,Java 却报 PKIX 错误

Tomcat 的 HTTPS 由 Connector 与 SSLHostConfig 提供。GeoTrust 签发的是服务器证书,CA 中间证书需要随服务端一起下发。浏览器常通过 AIA 自动补链,所以“浏览器绿锁”不代表服务端链完整;curl、Java、微信小程序、Android 旧版本通常只信任本地 truststore,缺中间证书就会报 PKIX path building failed 或 unable to get local issuer certificate。

常见根因有四类:一是只部署了叶子证书,未部署 fullchain;二是 PFX 导出时未包含 CA 链;三是 server.xml 仍指向旧文件或旧别名;四是密码或别名错误,导致 Tomcat 启动时 Cannot recover key。另一个根因是证书有效期规划过时:2026-03-15 起公开信任证书最长 200 天,若仍按 398 天排期会逾期;Let’s Encrypt 90 天更需要自动化。用 openssl x509 -enddate 与 keytool -list -v 核对。Tomcat 8.5+ 推荐 PKCS12/PFX,老版本用 JKS。OV 证书的组织信息不会替代 SAN,访问域名必须在 SAN 中。

2. 准备证书文件:PFX、JKS、fullchain 与私钥匹配

从 CA 下载或由控制台导出 PFX 后,先在工作目录做三件事:看信息、拆文件、校验证书链。以下命令可直接执行,注意把 example.com.pfx 和密码替换为实际值。

mkdir -p /opt/ssl/geotrust && cd /opt/ssl/geotrust
openssl pkcs12 -in example.com.pfx -info -noout
openssl pkcs12 -in example.com.pfx -nocerts -nodes -out example.com.key
openssl pkcs12 -in example.com.pfx -clcerts -nokeys -out example.com.crt
openssl pkcs12 -in example.com.pfx -cacerts -nokeys -out chain.crt
cat example.com.crt chain.crt > fullchain.crt
openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName
openssl verify -CAfile chain.crt example.com.crt
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5

两次 md5 必须一致,否则证书与私钥不匹配。若 PFX 不含链,用 CA 提供的中间证书拼接;不要用根证书替代中间证书。有效期核对用 openssl x509 -in fullchain.crt -noout -enddate。2026-05-07 之后签发的公开证书最长 200 天;旧证书可能仍是 398 天,Let’s Encrypt 为 90 天。转换 JKS 可执行:

keytool -importkeystore -srckeystore example.com.pfx -srcstoretype PKCS12 -srcstorepass 'PFX密码' -destkeystore example.com.jks -deststoretype JKS -deststorepass 'JKS密码' -destkeypass 'JKS密码' -noprompt
keytool -list -v -keystore example.com.jks -storepass 'JKS密码' | grep -E 'Alias|Entry type|Certificate chain length'

链长度应至少为 2,通常为 2 到 3。若显示 Certificate chain length: 1,说明只导入了叶子证书,必须重新导入 fullchain。

3. 完整实操步骤:从上传文件到启动 Tomcat 8443

第一步备份配置并放置文件。生产环境建议 PFX 权限为 600,属主为 tomcat:

cp $CATALINA_HOME/conf/server.xml /opt/ssl/server.xml.bak.$(date +%F)
install -m 600 -o tomcat -g tomcat example.com.pfx /opt/ssl/example.com.pfx
ss -lntp | grep 8443

第二步按下一节修改 server.xml,确认 certificateKeystoreFile、certificateKeystorePassword、certificateKeystoreType 三项与文件一致。第三步重启 Tomcat:

$CATALINA_HOME/bin/shutdown.sh
sleep 5
$CATALINA_HOME/bin/startup.sh
tail -n 100 $CATALINA_HOME/logs/catalina.out

第四步本机验证。若域名尚未解析到本机,用 -servername 与 –resolve 指定:

openssl s_client -connect 127.0.0.1:8443 -servername example.com -showcerts -CAfile /opt/ssl/geotrust/chain.crt </dev/null
curl -Iv --resolve example.com:8443:127.0.0.1 https://example.com:8443/
java -Djavax.net.debug=ssl:handshake -cp app.jar com.example.Main

openssl 输出应包含 Verify return code: 0 (ok)。若使用 JKS,先 keytool -list 确认别名。修改 server.xml 必须重启,Tomcat 不会自动重载 SSL 证书文件;替换证书后也要重启进程,否则仍加载旧文件。

4. 配置示例:Tomcat 8.5+/9/10 与老版本 JKS

Tomcat 8.5 及以上推荐 PKCS12/PFX,配置写在 SSLHostConfig 中。以下示例中密码请替换为实际值,不要在配置里保留示例密码。

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" maxThreads="150" SSLEnabled="true" scheme="https" secure="true">
  <SSLHostConfig>
    <Certificate certificateKeystoreFile="/opt/ssl/example.com.pfx"
                 certificateKeystorePassword="PFX密码"
                 certificateKeystoreType="PKCS12" />
  </SSLHostConfig>
</Connector>

若使用 JKS,需要指定 certificateKeystoreType 为 JKS,并在多别名时加 certificateKeyAlias:

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true">
  <SSLHostConfig>
    <Certificate certificateKeystoreFile="/opt/ssl/example.com.jks"
                 certificateKeystorePassword="JKS密码"
                 certificateKeystoreType="JKS"
                 certificateKeyAlias="tomcat" />
  </SSLHostConfig>
</Connector>

老版本 Tomcat 7 使用旧属性写法,且应显式启用 TLSv1.2 与 TLSv1.3:

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" scheme="https" secure="true"
           keystoreFile="/opt/ssl/example.com.jks" keystorePass="JKS密码" clientAuth="false"
           sslEnabledProtocols="TLSv1.2,TLSv1.3" />

Tomcat 10.1 仍支持 PKCS12,优先使用 certificateKeystoreType="PKCS12"。若一个 IP 多域名,用多个 SSLHostConfig 或 defaultSSLHostConfigName;不要同时保留旧 Connector,否则端口冲突或加载旧证书。

5. 对比表格:PFX 与 JKS、Tomcat 版本与证书有效期

维度 PFX/PKCS12 JKS 建议
Tomcat 8.5+ 原生支持 支持 优先 PFX,少一次转换
Tomcat 7 及更老 不直接支持 支持 用 keytool 转 JKS
文件内容 私钥+叶子+链 私钥+叶子+链 必须含中间证书
密码 storepass 统一保护 storepass/keypass 可不同 记录别名与密码
跨平台 好,OpenSSL 可处理 Java 专用 容器/CI 用 PFX
有效期 公开证书自 2026-03-15 最长 200 天;此前 398 天;Let’s Encrypt 90 天

选型结论:Tomcat 8.5+ 用 PFX;只有老 Tomcat 或必须用 JKS 才转换。若使用 JKS,keytool -list -v 看 Certificate chain length,若为 1 说明只导入叶子证书,必须重新导入 fullchain。有效期上,200 天不是固定续期日,建议到期前 30 天续期;Let’s Encrypt 90 天建议到期前 30 天自动续。GeoTrust OV 审核需要时间,别等到最后一天。

另外,PFX 与 JKS 都不是“越新越好”,关键是文件内链完整、密码正确、server.xml 指向同一个文件。迁移环境时把 PFX 与密码一起纳入密钥管理,不要提交到 Git。

6. 常见错误排查:真实报错与修复

报错 根因 修复
javax.net.ssl.SSLHandshakeException: PKIX path building failed: unable to find valid certification path to requested target 服务端链不完整或客户端 truststore 缺根/中间证书 用 fullchain 重建 PFX/JKS;openssl verify -CAfile chain.crt example.com.crt;Java 导入 CA
curl: (60) SSL certificate problem: unable to get local issuer certificate 未下发中间证书 cat leaf chain > fullchain.crt 后重导 PFX
java.security.cert.CertificateException: No subject alternative names present CSR 未加 SAN 或访问域名不在 SAN 重签证书,SAN 写全 DNS/IP
java.io.IOException: keystore password was incorrect server.xml 密码与 PFX/JKS 不一致 keytool -list -keystore example.com.jks -storepass 验证;改配置
java.security.UnrecoverableKeyException: Cannot recover key JKS 的 keypass 与 storepass 不同,未指定 certificateKeyAlias 转换时加 -destkeypass,配置加 certificateKeyAlias
ERR_SSL_VERSION_OR_CIPHER_MISMATCH 客户端只支持旧 TLS,或 Connector 协议套件不匹配 启用 TLSv1.2/TLSv1.3,禁用 SSLv3/TLSv1.0

排查时先看 Tomcat 日志:grep -i -E ‘SSL|Certificate|keystore’ $CATALINA_HOME/logs/catalina.out | tail -n 50。再用 openssl s_client -connect 127.0.0.1:8443 -servername example.com -showcerts </dev/null。若出现 Verify return code: 21 (unable to verify the first certificate),通常是链缺中间证书;若为 20 (unable to get local issuer certificate),检查本地 CA 文件或客户端 truststore。

7. 效果验证:openssl、curl、Java、浏览器四层确认

第一层用 openssl 看主题、签发者、有效期与 SAN:

openssl s_client -connect example.com:8443 -servername example.com -showcerts -CAfile /opt/ssl/geotrust/chain.crt </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
echo | openssl s_client -connect example.com:8443 -servername example.com 2>/dev/null | openssl x509 -noout -ext subjectAltName

第二层用 curl 验证链与 HTTP 响应。若 DNS 未切换,用 –resolve 指向测试机:

curl -Iv --resolve example.com:8443:127.0.0.1 https://example.com:8443/ 2>&1 | grep -E 'SSL certificate verify|subject:|issuer:|HTTP/'

应看到 SSL certificate verify ok。第三层用 Java 验证:keytool -printcert -sslserver example.com:8443 可打印服务端证书链;应用侧用 java -Djavax.net.debug=ssl:handshake -cp app.jar com.example.Main 2>&1 | grep -E ‘Found trusted certificate|Certificate chain|Exception’。若出现 Exception,回到证书链与 SAN 排查。

第四层用浏览器开发者工具 Security 面板查看证书链是否为 3 张左右、SAN 是否匹配、有效期是否覆盖当前时间。公网服务可再用 SSL Labs 或 openssl verify 复核。Tomcat 日志中不应出现 SEVERE 或 SSLException;8443 端口应处于 LISTEN 状态:ss -lntp | grep 8443。

8. 续期与自动化:200 天/90 天有效期下的部署节奏

公开信任证书自 2026-03-15 起最长 200 天,此前为 398 天;Let’s Encrypt 默认 90 天。GeoTrust OV 续期通常需要重新审核组织信息,建议到期前 30 天启动。先检查剩余时间:openssl x509 -checkend 2592000 -noout -in fullchain.crt;返回 0 表示 30 天内到期,返回 1 表示仍有余量。

替换证书文件后必须重启 Tomcat,因为 SSLHostConfig 不会自动监听文件变化:

cp example.com.pfx /opt/ssl/example.com.pfx.new
mv /opt/ssl/example.com.pfx.new /opt/ssl/example.com.pfx
$CATALINA_HOME/bin/shutdown.sh
sleep 5
$CATALINA_HOME/bin/startup.sh
openssl s_client -connect 127.0.0.1:8443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates

若使用 Let’s Encrypt 自动续期,可在 deploy-hook 中重新导出 PFX 并重启 Tomcat:

certbot renew --deploy-hook 'openssl pkcs12 -export -out /opt/ssl/example.com.pfx -inkey /etc/letsencrypt/live/example.com/privkey.pem -in /etc/letsencrypt/live/example.com/fullchain.pem -passout pass:CHANGE_ME && systemctl restart tomcat'

生产环境不要把真实密码写在命令行历史中,可用环境变量或受控脚本。续期后再次执行 openssl s_client 与 curl,确认 notAfter 已更新,并检查 catalina.out 无 SSL 相关异常。

常见问题

Tomcat 8.5+ 优先用 PFX/PKCS12,配置简单且 OpenSSL 可直接处理;Tomcat 7 及更老版本用 keytool 转 JKS,并确认 Certificate chain length 至少为 2。

浏览器会通过 AIA 自动补中间证书,Java 不会。服务端必须下发完整 fullchain;用 openssl verify 与 keytool -printcert -sslserver 检查链,缺中间证书就重新导出 PFX/JKS。

需要。Tomcat 不会自动重载 SSLHostConfig 指向的证书文件,替换 PFX/JKS 或改 Connector 后应 shutdown 再 startup,并确认进程加载的是新文件。

不对。公开信任 TLS 证书自 2026-03-15 起最长 200 天,此前才是 398 天;Let’s Encrypt 默认 90 天。用 openssl x509 -enddate 核对,并按到期前 30 天规划续期。

执行 openssl pkcs12 -in example.com.pfx -info -noout 查看条目,或拆出 chain.crt 后运行 openssl verify -CAfile chain.crt example.com.crt;JKS 用 keytool -list -v 看 Certificate chain length 是否大于 1。

先确认 server.xml 指向新 PFX/JKS,再重启 Tomcat;用 openssl s_client 看 notAfter 是否更新。若仍旧,检查是否有多余 Connector、反向代理缓存或负载均衡其他节点未更新。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。