跳到主要内容
Tomcat

GlobalSign SSL 证书 Tomcat 安装部署实战:PKCS12/JKS、证书链与排错

问题背景与根因:GlobalSign 证书在 Tomcat 上为何“浏览器正常、Java 报错”

GlobalSign 是欧洲老牌 CA,除 SSL/TLS 外还提供文档签名、S/MIME 等合规产品,审核流程规范。把 GlobalSign 签发的证书部署到 Tomcat 时,最常见的问题不是证书本身无效,而是服务端只发送了叶子证书,缺少中间证书;或者 keystore 类型、密码、别名与 server.xml 不一致。浏览器可能缓存或自动补链,但 curl、Java、小程序、支付回调往往严格校验证书链,于是出现 PKIX path building failed 或 unable to get local issuer certificate。另一个根因是主机名/SAN 不匹配:CSR 中 Common Name 写对不代表 SAN 完整,现代客户端只认 subjectAltName。还有 TLS 版本与加密套件不兼容、Java 信任库过旧、证书过期或超过 398 天有效期限制。先做两条快速诊断:openssl s_client -connect example.com:8443 -servername example.com -showcerts </dev/null 查看服务端是否返回叶子+中间证书;keytool -list -v -keystore /opt/ssl/example.com.pfx -storetype PKCS12 -storepass 'PFX密码' 查看别名、证书链长度和有效期。若输出中 Certificate chain length 只有 1,基本可判定缺中间证书。不要先怀疑 GlobalSign 根证书,先检查 fullchain 与 Tomcat 配置指向的文件是否一致。

准备文件:CSR、叶子证书、中间证书与私钥的对应关系

GlobalSign 签发后通常给出一张叶子证书和中间证书,根证书由客户端信任库内置。部署前把文件统一放到 /opt/ssl,命名建议:example.com.crt(叶子)、intermediate.crt(中间)、root.crt(根,备份用)、example.com.key(私钥)、fullchain.crt(叶子+中间)。如果只拿到 PFX,可用 OpenSSL 拆出:

openssl pkcs12 -in example.com.pfx -clcerts -nokeys -out example.com.crt -passin pass:'PFX密码'
openssl pkcs12 -in example.com.pfx -cacerts -nokeys -out chain.crt -passin pass:'PFX密码'
cat example.com.crt chain.crt > fullchain.crt
openssl pkcs12 -in example.com.pfx -nocerts -nodes -out example.com.key -passin pass:'PFX密码'

检查主题、颁发者、有效期和 SAN:openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName。检查私钥与证书是否匹配:openssl x509 -noout -modulus -in example.com.crt | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5 的输出必须一致。检查链顺序:openssl crl2pkcs7 -nocrl -certfile fullchain.crt | openssl pkcs7 -print_certs -noout,顺序应为叶子在前、中间在后。注意公网 TLS 证书最长有效期 398 天,GlobalSign 通常按年签发,Let’s Encrypt 为 90 天;续期后必须替换文件并重启 Tomcat,不能只改日期。

完整实操:生成 PKCS12 并校验密码、别名与证书链

Tomcat 8.5+ 推荐 PKCS12/PFX,JKS 仅用于兼容老系统。若已有 PEM,可重新打包为 PKCS12,别名设为 tomcat:

openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in fullchain.crt -name tomcat -passout pass:'PFX密码' -certpbe AES-256-CBC -keypbe AES-256-CBC -macalg sha256

如果 Tomcat 运行在较老 Java 8 上,遇到 Unsupported keystore algorithm,改用兼容算法:-certpbe PBE-SHA1-3DES -keypbe PBE-SHA1-3DES -macalg sha1。校验 PFX:openssl pkcs12 -info -in example.com.pfx -passin pass:'PFX密码' -noout;再用 keytool 确认别名和链长度:keytool -list -v -keystore example.com.pfx -storetype PKCS12 -storepass 'PFX密码'。输出中应看到 Alias name: tomcat、Certificate chain length: 2 或 3。需要 JKS 时执行:

keytool -importkeystore -srckeystore example.com.pfx -srcstoretype PKCS12 -srcstorepass 'PFX密码' -destkeystore example.com.jks -deststoretype JKS -deststorepass 'JKS密码' -destkeypass 'JKS密码' -destalias tomcat -noprompt

JKS 的 storepass 与 keypass 可以不同,但 server.xml 中 certificateKeystorePassword 必须与 storepass 一致;PKCS12 的 key 密码通常等于 store 密码。若报 Alias name [tomcat] does not exist,用 keytool -list -keystore example.com.jks -storepass 'JKS密码' 查实际别名,再填 certificateKeyAlias。最后设置权限:chown tomcat:tomcat /opt/ssl/* && chmod 600 /opt/ssl/*,避免 Tomcat 进程无读权限导致启动失败。

Tomcat server.xml 配置示例:PKCS12 与 JKS 双方案

编辑 $CATALINA_BASE/conf/server.xml,在 Service 内保留一个 8443 Connector。Tomcat 8.5/9/10 使用 SSLHostConfig;Tomcat 7/8.0 仍用 Connector 上的 keystoreFile/keystorePass/keystoreType,属性名不同。PKCS12 示例:

<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
           maxThreads='150' SSLEnabled='true' scheme='https' secure='true'>
  <SSLHostConfig sslProtocol='TLS' protocols='TLSv1.2,TLSv1.3'>
    <Certificate certificateKeystoreFile='/opt/ssl/example.com.pfx'
                 certificateKeystorePassword='PFX密码'
                 certificateKeystoreType='PKCS12'
                 certificateKeyAlias='tomcat' />
  </SSLHostConfig>
</Connector>

JKS 方案只改三处:certificateKeystoreFile='/opt/ssl/example.com.jks'、certificateKeystoreType='JKS'、密码改为 JKS storepass。若一个 Tomcat 绑定多个域名,可在同一 Connector 下配置多个 <SSLHostConfig hostName='a.example.com'>,每个包含自己的 Certificate;不要把所有证书塞进同一个别名。配置后先做语法检查:$CATALINA_HOME/bin/catalina.sh configtest,再重启:systemctl restart tomcat9。查看日志:tail -n 200 $CATALINA_BASE/logs/catalina.out,出现 Keystore was tampered with, or password was incorrect 时优先核对密码、storeType 和别名,而不是重装证书。若启用 SELinux,执行 restorecon -Rv /opt/ssl 并确认 Tomcat 有读权限。

PKCS12、JKS、PEM 三种部署方式对比

选择格式的核心是 Tomcat 版本、Java 版本和运维习惯。PKCS12 是跨平台标准,Tomcat 8.5+ 与 Java 8+ 均支持,适合新部署;JKS 是 Java 私有格式,兼容老 Tomcat,但密钥密码与库密码分离,容易配错;PEM 便于与 Nginx/Apache 共用 fullchain 和 key,但要求较新的 Tomcat 并正确设置 certificateFile 与 certificateKeyFile。对比如下:

方式 适用版本 优点 限制 Tomcat 关键参数
PKCS12/PFX Tomcat 8.5+,Java 8+ 单文件、跨平台、推荐 别名和密码需明确;老 Java 需兼容算法 certificateKeystoreType=’PKCS12′
JKS 老 Tomcat/Java 兼容 Java 原生、工具成熟 storepass 与 keypass 可不同,易错 certificateKeystoreType=’JKS’
PEM 较新 Tomcat 9/10 与 Nginx 共用、可读性好 需同时提供 fullchain 与私钥,权限要求高 certificateFile + certificateKeyFile

无论哪种方式,服务端都应发送叶子证书和中间证书,根证书通常不必随服务端发送。验证链完整性可用 openssl s_client -connect 127.0.0.1:8443 -servername example.com -showcerts </dev/null,输出中应至少有两张证书;若只有一张,浏览器可能正常但 Java 会报 PKIX path building failed。生产环境建议统一用 PKCS12,并在变更单中记录别名、密码保管方式和文件路径,避免续期时找不到对应关系。

常见错误与真实报错排查

下面按报错定位,不要盲目重签证书。1)curl: (60) SSL certificate problem: unable to get local issuer certificate:服务端缺中间证书。用 openssl s_client -connect example.com:8443 -servername example.com -showcerts </dev/null 数证书张数,修复 fullchain 后重启。2)sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target:Java 客户端信任库缺根/中间证书,或服务端链不完整。服务端先修 fullchain;客户端再导入根证书:keytool -importcert -alias globalsignroot -file root.crt -keystore $JAVA_HOME/jre/lib/security/cacerts -storepass changeit。3)keytool error: java.io.IOException: keystore password was incorrect 或 Keystore was tampered with, or password was incorrect:密码或类型错。执行 keytool -list -keystore example.com.pfx -storetype PKCS12 -storepass 'PFX密码' 验证;PKCS12 的 key 密码通常等于 store 密码。4)java.io.IOException: Invalid keystore format:把 PFX 当成 JKS,或 server.xml 的 certificateKeystoreType 写错。5)javax.net.ssl.SSLHandshakeException: No name matching example.com found 或 No subject alternative names present:SAN/主机名不匹配,用 openssl x509 -in example.com.crt -noout -ext subjectAltName 检查,必要时重签 CSR 并包含全部域名。6)Alias name [tomcat] does not exist:别名不一致,用 keytool -list -v 查实际别名并修改 certificateKeyAlias。7)续期后仍返回旧证书:确认 server.xml 指向新文件、没有多个 Connector 抢占 8443,并彻底重启 Tomcat 进程。

生效验证:openssl、curl、Java 与浏览器四层检查

重启后先确认端口监听:ss -lntp | grep 8443。第一层用 OpenSSL 看握手和链:openssl s_client -connect 127.0.0.1:8443 -servername example.com -showcerts </dev/null,重点看 Verify return code: 0 (ok)、协议版本和证书链张数;若返回 verify error:num=20:unable to get local issuer certificate,仍是链不完整。第二层用 curl 模拟真实 HTTPS:curl -vI https://example.com:8443 --resolve example.com:8443:127.0.0.1,应看到 SSL certificate verify ok 和 HTTP 200/302;不要用 -k 掩盖问题。第三层用 Java 打印握手:在 setenv.sh 加入 JAVA_OPTS=$JAVA_OPTS' -Djavax.net.debug=ssl:handshake' 后重启,日志中应出现 Produced ClientHello、Consuming ServerHello、Found trusted certificate;也可用 keytool -printcert -sslserver example.com:8443 -rfc 查看服务端实际下发的链。第四层浏览器访问 https://example.com:8443,确认锁标、证书颁发者为 GlobalSign、SAN 包含当前域名,并用开发者工具查看 TLS 版本。最后检查证书剩余天数:openssl s_client -connect example.com:8443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -checkend 2592000,返回 Certificate will not expire 表示 30 天内不过期。

续期、自动化与 398 天有效期注意事项

公网 TLS 证书自 2020 年起最长有效期 398 天,GlobalSign 通常签发 1 年期证书,Let’s Encrypt 为 90 天。不要把 398 天理解为可以拖到最后一天:Tomcat 不会自动重载证书文件,续期后应替换文件并重启进程。推荐流程:新 PFX 先放临时路径,校验通过后原子替换:cp example.com.pfx /opt/ssl/example.com.pfx.new && mv /opt/ssl/example.com.pfx.new /opt/ssl/example.com.pfx,再执行 systemctl restart tomcat9。验证新证书序列号:openssl s_client -connect example.com:8443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -serial -dates -issuer,与 GlobalSign 后台订单信息比对。监控脚本可每天执行 openssl s_client -connect example.com:8443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -checkend 2592000,失败即告警。若使用多实例或容器,证书文件要挂载到所有节点,不能只更新一台;Kubernetes 中更新 Secret 后还需滚动重启 Pod。GlobalSign 证书续期通常沿用原私钥或重新签发,若重新生成 CSR,务必同步更新 fullchain 与私钥,避免模数不匹配。Let’s Encrypt 90 天证书可用 certbot 自动续期,但 Tomcat 仍需部署后重载或重启,建议用钩子脚本完成。

常见问题

Tomcat 8.5+ 优先用 PKCS12/PFX,单文件且跨平台;JKS 只用于兼容老 Tomcat。无论哪种,都要包含叶子证书和中间证书,并在 server.xml 中正确填写 storeType、密码和别名。

通常是服务端只发了叶子证书,缺少中间证书;Java 默认信任库也不会自动补链。把 fullchain 部署到 Tomcat,并确认 Java 客户端 cacerts 含 GlobalSign 根证书,再重启验证。

先核对 server.xml 的 certificateKeystorePassword、certificateKeystoreType 和别名。用 keytool -list 验证密码;PFX 的 key 密码通常等于 store 密码,JKS 可能不同,必要时重新导入并指定 destkeypass。

确认 server.xml 指向的是新文件,且没有多个 Connector 或多个 Tomcat 实例占用 8443;然后彻底重启 Tomcat,不要只 reload 应用。用 openssl s_client 查看序列号和有效期,确认新证书已生效。

公网 TLS 证书最长有效期 398 天;GlobalSign 常见为 1 年期,Let’s Encrypt 为 90 天。前者适合人工审核和合规场景,后者适合自动化续期,但都要在到期前完成替换和重启。

服务端应部署叶子证书加中间证书的 fullchain,根证书通常不必随服务端发送,因为客户端信任库已内置。若 Java 客户端不信任,应在客户端 cacerts 导入根证书,而不是只改服务端。

内容审核

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