GlobalSign SSL 证书部署到 Tomcat 完整教程:PKCS12 配置、证书链修复与验证
问题背景:GlobalSign 证书在 Tomcat 上为何部署失败
GlobalSign 是欧洲老牌 CA,除 SSL 外还提供文档签名、S/MIME 等合规产品,欧洲与日本市场占有率高。其公共 TLS 证书受 CA/B Forum 约束,当前最长有效期 398 天,续期周期约 13 个月;Let’s Encrypt 仍为 90 天,二者自动化策略不同。很多运维把 GlobalSign 签发的 .crt 和私钥直接丢给 Tomcat,结果启动失败或客户端报证书链错误。典型现象有三类:Tomcat 启动日志出现 Keystore was tampered with, or password was incorrect;浏览器能打开但 curl、Java、小程序报 PKIX path building failed;续期后浏览器仍显示旧证书。根因通常不是证书本身,而是格式与配置不匹配:Tomcat 8.5+ 推荐 PKCS12/PFX,旧版 Tomcat 7 习惯 JKS;PKCS12 的 store password 与 key password 可能不同;GlobalSign 交付文件通常只含叶子证书,必须把中间证书合并成 fullchain;Tomcat 不会自动重新加载证书文件。下面按文件准备、Connector 配置、对比选型、报错排查、验证五步展开,命令可直接在 Linux 上执行。
根因分析:证书链、Keystore 类型与 Tomcat 版本
Tomcat 的 HTTPS 由 Connector 和 SSLHostConfig 驱动。Tomcat 8.5+ 原生支持 PKCS12,通过 certificateKeystoreType=PKCS12 指定;Tomcat 7 及更早版本通常用 JKS,配置项是 keystoreFile、keystorePass、keystoreType。若在 Tomcat 8.5+ 不写 certificateKeystoreType,默认按 JKS 读取,PKCS12 就会报密码错误或无法恢复密钥。第二个根因是证书链:GlobalSign 公共证书一般由 GlobalSign Root CA – R3/R6 签发,服务器必须发送叶子证书和中间证书,客户端才有机会构建到根。只部署叶子证书时,浏览器可能靠 AIA 补链成功,但 Java、curl、小程序不会自动补链,于是报 unable to find valid certification path。第三个根因是密码:openssl pkcs12 -export 可分别设置导入密码和密钥密码,Tomcat 的 certificateKeystorePassword 默认同时用于 store 和 key;若二者不同,需增加 certificateKeyPassword。第四个根因是文件权限与路径:Tomcat 进程用户必须能读 p12,绝对路径最稳。第五个根因是 SNI:多域名必须用 -servername 验证,否则 openssl 可能拿到默认证书。可用 keytool -list -v -keystore example.com.p12 -storetype PKCS12 -storepass 密码 查看别名和链长度;用 openssl pkcs12 -info -in example.com.p12 -passin pass:密码 -noout 检查 MAC 与加密算法。确认这些点后再改 server.xml,能少走很多弯路。
实操步骤一:整理 GlobalSign 证书文件并生成 PKCS12
先把 GlobalSign 交付文件放到 /opt/ssl,常见文件为 example.com.crt(叶子)、intermediate.crt(中间)、root.crt(根,通常不需要部署到服务器)。执行:
mkdir -p /opt/ssl && cd /opt/ssl
cat example.com.crt intermediate.crt > fullchain.crt
openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt
openssl pkcs12 -export -in fullchain.crt -inkey example.com.key -out example.com.p12 -name tomcat -passout pass:StrongPass123
keytool -list -v -keystore example.com.p12 -storetype PKCS12 -storepass StrongPass123
openssl pkcs12 -info -in example.com.p12 -passin pass:StrongPass123 -noout
若 CA 给的是 .p7b,先转换:openssl pkcs7 -print_certs -in cert.p7b -out cert.pem。fullchain 的顺序必须是叶子在前、中间在后,不能把根证书塞进 p12 作为链的一部分,否则部分客户端会报链过长或重复。导出时 -name tomcat 指定别名,后面 Tomcat 可用 certificateKeyAlias=tomcat 精确匹配;若省略别名,Tomcat 会取第一个 key entry。导出后必须用 keytool 检查条目:应有 PrivateKeyEntry,证书链长度至少 2。再执行 chmod 600 example.com.p12 和 chown tomcat:tomcat example.com.p12,保证 Tomcat 用户可读。注意 GlobalSign 公共 TLS 证书最长 398 天,续期后不要复用旧 p12,必须用新 fullchain 和新私钥重新导出,否则 notAfter 仍是旧日期。
实操步骤二:在 Tomcat 8.5+ 配置 HTTPS Connector
编辑 $CATALINA_HOME/conf/server.xml,在 Service 内加入或替换 Connector。Tomcat 8.5+ 推荐 Http11NioProtocol,配置如下:
<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="StrongPass123"
certificateKeystoreType="PKCS12"
certificateKeyAlias="tomcat" />
</SSLHostConfig>
</Connector>
关键参数:certificateKeystoreFile 用绝对路径;certificateKeystoreType 必须写 PKCS12,否则 Tomcat 按 JKS 读取;certificateKeystorePassword 与导出密码一致;certificateKeyAlias 与 keytool 看到的别名一致。若 PKCS12 的 key password 与 store password 不同,增加 certificateKeyPassword。密码含 & 或 < 时要在 XML 中转义为 & 和 <。修改后先做语法检查:xmllint –noout conf/server.xml。然后重启:systemctl restart tomcat,或 $CATALINA_HOME/bin/shutdown.sh 后 startup.sh。查看日志:tail -f logs/catalina.out,出现 Starting ProtocolHandler [https-nio-8443] 表示 Connector 已监听。旧版 Tomcat 7 用 JKS,配置为 keystoreFile、keystorePass、keystoreType=JKS,并用 keytool -importkeystore -srckeystore example.com.p12 -srcstoretype PKCS12 -destkeystore example.com.jks -deststoretype JKS 转换。Tomcat 不会自动 reload 证书文件,续期后必须重启。
配置示例:单域名与 SNI 多域名 server.xml 片段
单域名最简配置可把 SSLHostConfig 的 hostName 省略,Tomcat 使用 defaultSSLHostConfigName。生产环境建议显式写 hostName,便于 SNI 匹配。多域名时,每个域名一个 SSLHostConfig,各自指向独立 p12;如果一张多域名证书覆盖多个 SAN,也可共用一个 Certificate,但 hostName 仍需分别声明。示例:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="200" SSLEnabled="true" scheme="https" secure="true"
defaultSSLHostConfigName="example.com">
<SSLHostConfig hostName="example.com">
<Certificate certificateKeystoreFile="/opt/ssl/example.com.p12"
certificateKeystorePassword="StrongPass123"
certificateKeystoreType="PKCS12"
certificateKeyAlias="tomcat" />
</SSLHostConfig>
<SSLHostConfig hostName="www.example.com">
<Certificate certificateKeystoreFile="/opt/ssl/www.example.com.p12"
certificateKeystorePassword="StrongPass456"
certificateKeystoreType="PKCS12"
certificateKeyAlias="tomcat" />
</SSLHostConfig>
</Connector>
注意 defaultSSLHostConfigName 必须对应一个已声明的 hostName,否则 Tomcat 启动报 IllegalArgumentException。若使用同一张多域名证书,两个 SSLHostConfig 可指向同一个 p12,但 certificateKeyAlias 要一致。Tomcat 10/11 的配置属性与 Tomcat 9 基本一致,包名仍是 org.apache.coyote.http11.Http11NioProtocol。若前面有 Nginx 或负载均衡,建议在 Tomcat 只保留内网 HTTP,由入口层终止 TLS;此时 GlobalSign 证书部署在 Nginx,Tomcat 不需要改。验证 SNI 时必须带 -servername,否则默认证书可能不是目标域名。配置改完用 catalina.sh configtest 或 xmllint 检查,再重启。
对比表格:PKCS12、JKS、PEM 三种格式怎么选
Tomcat 部署 GlobalSign 证书时,格式选择直接影响配置项和报错类型。下表按 Tomcat 版本、私钥存放、密码模型和常见故障对比:
| 项目 | PKCS12/PFX | JKS | PEM |
|---|---|---|---|
| Tomcat 8.5+ 原生支持 | 是,推荐 | 是,兼容旧版 | 需 APR 或额外配置 |
| 私钥与证书链 | 同一文件 | 同一文件 | 私钥与 fullchain 分离 |
| 密码模型 | storepass 与 keypass 可不同 | storepass 与 keypass 可不同 | 私钥可加密 |
| 推荐场景 | Tomcat 8.5/9/10/11 | Tomcat 7 及更早 | Nginx/Apache/HAProxy |
| 转换命令 | openssl pkcs12 -export | keytool -importkeystore | cat fullchain.crt |
| 常见报错 | password incorrect | alias 不存在 | 链不完整 |
选型建议:新项目直接用 PKCS12,Tomcat 8.5+ 的 certificateKeystoreType 写 PKCS12 即可;只有维护 Tomcat 7 或旧 Java 环境才转 JKS。JKS 转换命令为 keytool -importkeystore -srckeystore example.com.p12 -srcstoretype PKCS12 -destkeystore example.com.jks -deststoretype JKS,转换后必须用 keytool -list -v 确认 PrivateKeyEntry 和链长度。PEM 不是 Tomcat 8.5+ 默认 Connector 的原生格式,除非启用 APR;不要把 .crt 和 .key 直接填到 certificateKeystoreFile,否则会报 Keystore was tampered with。GlobalSign 公共 TLS 证书最长 398 天,Let’s Encrypt 为 90 天,格式选择不影响有效期,但影响续期脚本:PKCS12 需重新导出,JKS 需重新导入,PEM 直接替换文件。生产环境建议保留 fullchain.crt、私钥和 p12 三份文件,权限 600。
常见错误排查:真实报错与修复命令
以下报错在 GlobalSign + Tomcat 组合中出现频率最高,按日志关键字定位:
java.io.IOException: Keystore was tampered with, or password was incorrect:密码错或文件损坏。先执行 keytool -list -v -keystore example.com.p12 -storetype PKCS12 -storepass StrongPass123 验证密码;若 key password 不同,在 Certificate 中加 certificateKeyPassword。重新导出时统一密码:openssl pkcs12 -export -in fullchain.crt -inkey example.com.key -out example.com.p12 -name tomcat -passout pass:StrongPass123。javax.net.ssl.SSLHandshakeException: PKIX path building failed或unable to find valid certification path to requested target:服务器未发送中间证书,或客户端信任库缺 GlobalSign 根。用 openssl s_client -connect 127.0.0.1:8443 -servername example.com -showcerts 检查是否返回 2 张以上证书;把 intermediate.crt 合并进 fullchain 后重新导出 p12。Java 客户端可导入根:keytool -importcert -alias globalsignroot -file root.crt -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit。curl: (60) SSL certificate problem: unable to get local issuer certificate:链不完整。执行 cat example.com.crt intermediate.crt > fullchain.crt,重新生成 p12,重启 Tomcat。CertificateException: No certificate found with name tomcat:certificateKeyAlias 写错。用 keytool -list -v 查看别名,改成实际别名,或删除 alias 让 Tomcat 取第一个 key entry。java.io.FileNotFoundException: /opt/ssl/example.com.p12 (Permission denied):Tomcat 用户无读权限。执行 chown tomcat:tomcat /opt/ssl/example.com.p12 && chmod 600 /opt/ssl/example.com.p12。- 续期后仍显示旧证书:Tomcat 不会自动 reload,执行 systemctl restart tomcat,并用 openssl x509 -noout -dates 确认 notAfter 已更新;检查是否改的是旧路径。
排查顺序建议:先看 catalina.out 的 Connector 启动日志,再用 openssl 看链,最后用 keytool 看别名和密码。不要同时改多个变量,否则无法定位。
效果验证:openssl、curl、Java 三重检查
重启后先在本机验证,不要直接看浏览器。第一步用 openssl 检查证书链和有效期:
openssl s_client -connect 127.0.0.1:8443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect 127.0.0.1:8443 -servername example.com -verify_return_error </dev/null
输出中 i: 应为 GlobalSign 中间 CA,s: 为你的域名,notAfter 距签发不超过 398 天。若 verify 返回 0 表示链验证通过;返回 21 表示 unable to verify the first certificate,通常是缺中间证书。第二步用 curl 模拟真实 SNI:curl -vI https://example.com:8443 –resolve example.com:8443:127.0.0.1,重点看 SSL certificate verify ok 和 subjectAltName。第三步用 Java 客户端验证,排除 JVM 信任库问题:java -Djavax.net.debug=ssl:handshake -cp . SSLTest https://example.com:8443,或 keytool -printcert -sslserver example.com:8443 -rfc。若 Java 报 PKIX,而 curl 正常,说明 JVM cacerts 缺 GlobalSign 根,不是 Tomcat 配置问题。最后浏览器访问 https://example.com:8443,打开证书面板确认链为叶子 → GlobalSign 中间 → GlobalSign 根,且有效期正确。多域名站点每个域名都要带 -servername 验证一次。建议把上述 openssl 命令写进续期后的检查脚本,避免只重启不验证。
常见问题
不是。Tomcat 8.5+ 推荐 PKCS12/PFX,也可用 JKS;Tomcat 7 及更早版本通常用 JKS。若启用 APR 连接器,可用 PEM。关键是私钥、叶子证书和中间证书完整,且 Connector 中的密码与 keystore 实际密码一致。
先确认 certificateKeystoreType 是否写成 PKCS12,再核对 certificateKeystorePassword 与导出密码。若 PKCS12 的 key password 与 store password 不同,增加 certificateKeyPassword。用 keytool -list -v 验证文件可读,必要时重新导出 p12 并重启 Tomcat。
通常是服务器未发送中间证书,或 JVM 信任库缺 GlobalSign 根。先用 openssl s_client -showcerts 检查是否返回中间证书;把 intermediate.crt 合并进 fullchain 后重新导出 p12。Java 端可将 GlobalSign 根导入 cacerts,但生产环境优先修服务器链。
可以。使用带多个 SAN 的证书,在 server.xml 中为每个域名声明 SSLHostConfig,并让 Certificate 指向同一个 p12。验证时必须用 openssl s_client 加 -servername 分别检查,否则可能只看到默认证书。
需要。Tomcat 不会自动重新加载 certificateKeystoreFile,续期后要用新 fullchain 和新私钥重新导出 p12,替换旧文件并重启 Tomcat。重启后用 openssl x509 -noout -dates 确认 notAfter 已更新,并检查是否仍指向旧路径。