Sectigo SSL 证书 Tomcat 部署实战:PKCS12/JKS、配置示例与报错排查
问题背景与根因:Tomcat 部署 Sectigo 证书为什么容易失败
Sectigo(原 Comodo CA)的 DV 证书通常分钟级签发,OV 约 1-3 个工作日,EV 约 3-5 个工作日,通配符和多域名方案价格有优势。但证书签发成功不等于 Tomcat 能直接用:Tomcat 走 Java TLS 栈,不读取操作系统证书库,服务端必须发送“叶子证书 + 中间证书”的完整链;只放叶子证书时,浏览器可能靠 AIA 补链正常,而 curl、Java、小程序、支付回调会报 PKIX 或 unable to get local issuer certificate。另一个根因是文件格式与密码:Tomcat 8.5+ 原生支持 PKCS12,老系统仍用 JKS;PFX 导入密码、JKS storepass/keypass 不一致,都会导致 Keystore was tampered with 或 Cannot recover key。公网 TLS 证书最长有效期已缩短到 398 天,Let’s Encrypt 为 90 天,续期后忘记重启 Tomcat 也会继续使用旧证书。下面按文件准备、导入、Connector 配置、排错和验证逐步处理。
准备证书文件:确认 fullchain、私钥与密码
从 Sectigo 下载或邮件中通常得到 example.com.crt、example.com.ca-bundle、example.com.key,也可能直接得到 example.com.pfx。部署前先核对证书主题、签发者、有效期和链:
openssl x509 -in example.com.crt -noout -subject -issuer -dates
openssl pkcs12 -info -in example.com.pfx -noout
openssl pkcs12 -in example.com.pfx -nokeys -passin pass:'PFX密码' | openssl x509 -noout -subject -issuer -dates
如果只有 crt 和 ca-bundle,需要合并为 fullchain,再导出 PKCS12:
cat example.com.crt example.com.ca-bundle > fullchain.crt
openssl pkcs12 -export -out example.com.p12 -inkey example.com.key -in fullchain.crt -name example.com -passout pass:'PFX密码'
核对私钥与证书是否匹配。RSA 证书比对 modulus 的 MD5,ECDSA 证书比对公钥 SHA-256:
openssl x509 -in example.com.crt -noout -modulus | openssl md5
openssl rsa -in example.com.key -noout -modulus | openssl md5
openssl x509 -in example.com.crt -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
注意:服务端 PKCS12 中应包含叶子证书和中间证书,根证书通常不必随服务端发送;但 Java 客户端的 truststore 必须包含对应根证书。PFX 密码不要用特殊字符导致启动脚本转义错误,建议先用简单密码验证,上线后再改强密码。
生成 PKCS12 或 JKS:完整可执行命令
新部署优先用 PKCS12,Tomcat 8.5/9/10/11 均可直接读取。若旧系统或监控工具只认 JKS,再用 keytool 转换。先生成 PKCS12:
openssl pkcs12 -export -out /opt/ssl/example.com.p12 -inkey /opt/ssl/example.com.key -in /opt/ssl/fullchain.crt -name example.com -passout pass:'PFX密码'
chmod 600 /opt/ssl/example.com.p12
chown tomcat:tomcat /opt/ssl/example.com.p12
转换为 JKS 并检查别名与链长度:
keytool -importkeystore -srckeystore /opt/ssl/example.com.p12 -srcstoretype PKCS12 -srcstorepass 'PFX密码' -destkeystore /opt/ssl/example.com.jks -deststoretype JKS -deststorepass 'JKS密码' -destkeypass 'JKS密码' -noprompt
keytool -list -v -keystore /opt/ssl/example.com.jks -storepass 'JKS密码'
输出中重点看 Alias name、Entry type 是否为 PrivateKeyEntry、Certificate chain length 是否大于 1。若链长度只有 1,说明只导入了叶子证书,Java 客户端会报 PKIX path building failed。JKS 的 storepass 与 keypass 建议设为相同值,避免 Tomcat 启动时报 Cannot recover key。PKCS12 的 key password 通常与 store password 一致;如果 CA 提供的 PFX 有独立密码,直接使用原密码,不要重复导出破坏链。
配置 Tomcat Connector:8.5/9/10/11 示例
编辑 $CATALINA_HOME/conf/server.xml,在 Service 内增加或替换 8443 Connector。Tomcat 8.5+ 推荐使用 SSLHostConfig 与 Certificate,不要把旧版 keystoreFile 直接写在 Connector 上。示例使用 PKCS12:
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
maxThreads='150' SSLEnabled='true' scheme='https' secure='true'>
<SSLHostConfig>
<Certificate certificateKeystoreFile='/opt/ssl/example.com.p12'
certificateKeystorePassword='PFX密码'
certificateKeystoreType='PKCS12' />
</SSLHostConfig>
</Connector>
如果使用 JKS,只改三处:certificateKeystoreFile 指向 .jks,certificateKeystorePassword 填 JKS storepass,certificateKeystoreType 改为 JKS。多域名或 SNI 场景可在同一个 Connector 下配置多个 SSLHostConfig,例如 hostName=’example.com’ 与 hostName=’api.example.com’,每个 host 下放各自的 Certificate。修改后先做 XML 语法检查再启动:
xmllint --noout $CATALINA_HOME/conf/server.xml
$CATALINA_HOME/bin/shutdown.sh
$CATALINA_HOME/bin/startup.sh
tail -n 100 $CATALINA_HOME/logs/catalina.out
生产环境建议把 8080 跳转到 8443,或在前置 Nginx/HAProxy 终止 TLS。若 Tomcat 前面有反向代理,Tomcat 只处理内网 HTTP 时,证书应部署在代理层,不要重复配置。注意端口、防火墙和 SELinux:8443 未放行时,本地 openssl 能通但外网访问失败。
PKCS12 与 JKS、Sectigo 证书类型对比
格式选择直接影响部署复杂度。Tomcat 8.5 以后 PKCS12 是默认推荐格式,JKS 主要用于兼容旧工具。对比见下表:
| 项目 | PKCS12 | JKS |
|---|---|---|
| Tomcat 支持 | 8.5+ 原生支持,推荐 | 支持,需 keytool 转换 |
| 文件扩展名 | .p12/.pfx | .jks |
| 密码模型 | storepass 与 keypass 通常一致 | storepass 与 keypass 可分开,建议一致 |
| 常用命令 | openssl pkcs12 | keytool -importkeystore |
| 适用场景 | 新部署、跨平台、CI/CD | 老系统、只认 JKS 的监控/网关 |
Sectigo 证书类型与签发时间也要与业务匹配:DV 分钟级签发,只验证域名控制权;OV 约 1-3 个工作日,需组织验证;EV 约 3-5 个工作日,保障金最高约 50 万美元,适合高信任场景。公网 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天,不能再用多年期证书。通配符证书覆盖同一主域下一级子域,多域名证书按 SAN 数量计费,购买前统计好域名清单。
| 类型 | 签发时间 | 验证内容 | 典型用途 |
|---|---|---|---|
| DV | 分钟级 | 域名控制权 | 测试、个人站、内部工具 |
| OV | 1-3 个工作日 | 组织真实性 | 企业官网、API |
| EV | 3-5 个工作日 | 严格组织验证 | 金融、支付、高信任入口 |
常见错误排查:真实报错与修复命令
先看 catalina.out 和客户端报错,再判断是链、密码、端口还是协议问题。高频报错如下:
| 报错 | 根因 | 修复 |
|---|---|---|
| java.security.cert.CertPathValidatorException: Path does not chain with any of the trust anchors | 服务端只发叶子证书,缺中间证书 | 导入 fullchain 到 PKCS12/JKS,确认链长度大于 1 |
| javax.net.ssl.SSLHandshakeException: PKIX path building failed | Java 客户端 truststore 缺根证书 | 把 Sectigo 根/中间证书导入客户端 truststore |
| curl: (60) SSL certificate problem: unable to get local issuer certificate | 链不完整或系统 CA 过期 | 用 fullchain 重新导出,更新 ca-certificates |
| java.io.IOException: Keystore was tampered with, or password was incorrect | 密码错误或 storeType 写错 | 核对 certificateKeystorePassword 与 Type |
| java.security.UnrecoverableKeyException: Cannot recover key | JKS keypass 与 storepass 不一致 | 重新转换并设置相同密码 |
| SSLHandshakeException: no cipher suites in common | 协议/套件不匹配或客户端过旧 | 检查 TLS 版本、证书密钥类型与 Connector 配置 |
排查命令:
openssl s_client -connect 127.0.0.1:8443 -servername example.com -showcerts </dev/null
openssl s_client -connect 127.0.0.1:8443 -servername example.com -verify_return_error </dev/null
keytool -list -v -keystore /opt/ssl/example.com.jks -storepass 'JKS密码'
grep -i -E 'SEVERE|Exception|SSL' $CATALINA_HOME/logs/catalina.out
若浏览器正常但 Java 报错,优先怀疑链不完整;若本地 openssl 正常但外网失败,检查安全组、防火墙和 DNS;若续期后仍旧证书,确认 Connector 指向新文件并已重启 Tomcat。
效果验证:从本机、外网与 Java 客户端三端确认
部署完成后不要只看浏览器锁标。先用 openssl 验证证书主题、签发者、有效期和链:
openssl s_client -connect example.com:8443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:8443 -servername example.com -verify_return_error </dev/null
再用 curl 强制解析到本机,检查 HTTP 状态和 TLS 握手:
curl -Iv --resolve example.com:8443:127.0.0.1 https://example.com:8443/
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}' https://example.com:8443/
Java 应用可用调试参数观察握手和链:
java -Djavax.net.debug=ssl:handshake -jar app.jar
keytool -printcert -sslserver example.com:8443
预期结果:证书 subject 为你的域名,issuer 为 Sectigo 对应中间 CA,NotAfter 不超过 398 天;openssl 无 verify error;curl 返回 200 且 ssl_verify_result 为 0;Java 日志中能看到 Certificate chain length 大于 1。最后用手机 4G、小程序或支付回调实际访问一次,避免内网 DNS 或代理导致假成功。
续期、备份与生产注意事项
Sectigo 公网 TLS 证书最长 398 天,Let’s Encrypt 为 90 天,必须建立续期台账。续期后重新导出 PKCS12/JKS,替换 /opt/ssl 下文件,然后重启 Tomcat;仅覆盖文件不会自动加载。建议保留旧文件至少一个周期:
cp /opt/ssl/example.com.p12 /opt/ssl/example.com.p12.$(date +%F)
systemctl restart tomcat
systemctl status tomcat --no-pager
openssl s_client -connect 127.0.0.1:8443 -servername example.com </dev/null | openssl x509 -noout -dates
自动化场景可用 certbot 的 deploy-hook 重启服务:
certbot renew --deploy-hook 'systemctl restart tomcat'
权限方面,keystore 只允许 tomcat 用户读取,目录不要放在 Web 根目录;备份时加密保存私钥和 PFX 密码。多实例部署要同步更新每台机器,负载均衡健康检查应覆盖 8443。若使用 Nginx 终止 TLS,Tomcat Connector 可退回 HTTP,但代理到后端的 X-Forwarded-Proto 要正确设置,否则应用生成的重定向链接仍是 http。
常见问题
不必。Tomcat 8.5 及以上原生支持 PKCS12,推荐直接用 .p12/.pfx,并在 Connector 中把 certificateKeystoreType 设为 PKCS12;只有老版本 Tomcat 或只认 JKS 的周边工具才需要 keytool 转换。
通常是服务端证书链不完整:只发送了叶子证书,没有发送中间证书。浏览器可借助 AIA 补链,Java 不会。请把 Sectigo 的叶子证书与中间证书合并为 fullchain 后重新导出 PKCS12/JKS,并确认 Certificate chain length 大于 1。
公网 TLS 证书最长有效期为 398 天,Sectigo 签发的证书也受此限制;DV 通常分钟级签发,OV 约 1-3 个工作日,EV 约 3-5 个工作日。Let’s Encrypt 的有效期是 90 天,续期策略要分别设置。
需要。Tomcat 在启动时加载 Connector 的 keystore,直接覆盖证书文件通常不会自动生效。替换 .p12/.jks 后应重启 Tomcat,再用 openssl s_client 检查 NotAfter 是否为新日期,并确认配置路径指向新文件。
RSA 证书分别对证书和私钥计算 modulus 的 MD5,两个值一致即匹配;ECDSA 证书则分别导出公钥并计算 SHA-256 比对。若不一致,说明私钥与证书不是同一对,需重新向 CA 签发或找回正确私钥。
可以。PKCS12 使用自己的导出密码,转换为 JKS 时可设置新的 storepass 和 keypass;Tomcat 配置里填的是 keystore 密码。建议 JKS 的 storepass 与 keypass 保持一致,避免出现 Cannot recover key。