GlobalSign SSL 证书 Tomcat 安装部署教程:PKCS12/JKS 配置、证书链校验与报错排查
问题背景与根因:GlobalSign 证书在 Tomcat 上为何“浏览器正常、Java 报错”
GlobalSign 是欧洲老牌 CA,除 SSL 外提供文档签名、S/MIME 等合规产品,欧洲与日本市场占有率高,审核流程规范。把 GlobalSign 签发的公有 TLS 证书部署到 Tomcat 时,最常见现象是浏览器访问 8443 正常,但 curl、Java 客户端、小程序或 Android 端提示证书链不完整。根因通常不是证书本身,而是 Tomcat 的 keystore 只包含叶子证书、缺少中间 CA,或 PKCS12/JKS 类型、密码、别名配置不一致。另需注意:公有 TLS 证书最长有效期已按 CA/B Forum 规则缩短为 398 天,Let’s Encrypt 为 90 天,续期后必须重新导入并 reload/restart Tomcat。先做两个基础检查:openssl s_client -connect example.com:8443 -servername example.com -showcerts </dev/null 查看返回链是否包含中间证书;curl -vI https://example.com:8443 观察是否报 unable to get local issuer certificate。若 openssl 返回 Verify return code: 21 (unable to verify the first certificate),基本可判定链不完整。Tomcat 8.5+ 推荐 PFX/PKCS12,老版本才用 JKS;不要混用“叶子证书 + 私钥”直接当 fullchain 使用。
根因拆解:证书链、PKCS12/JKS 与 Tomcat Connector 的匹配关系
Tomcat 的 TLS 由 Connector 和 SSLHostConfig 驱动,证书文件只是其中一环。GlobalSign 通常下发叶子证书、中间证书和根证书;服务端 keystore 应包含“叶子 + 中间”,根证书由客户端信任库决定,不要强行塞进服务端链。PFX/PKCS12 是二进制容器,包含私钥、证书和别名;JKS 是 Java 旧格式,Tomcat 8.5+ 仍可读,但新部署优先 PKCS12。关键匹配项有四个:certificateKeystoreType 必须与文件格式一致;certificateKeystorePassword 是容器密码,不是私钥密码;certificateKeyAlias 要指向含私钥的条目;证书 SAN 必须包含实际访问域名。Tomcat 8.5/9/10 使用 <SSLHostConfig> 与 <Certificate>,Tomcat 7/8.0 使用 keystoreFile、keystorePass。若把 PFX 配成 keystoreType='JKS',启动会报 java.io.IOException: Invalid keystore format;若密码错,报 keystore password was incorrect。证书最长 398 天,续期后旧文件不覆盖或配置仍指向旧路径,会出现“已续期但不生效”。因此排错顺序应是:文件格式 → 链完整性 → 私钥匹配 → 域名 SAN → Connector 配置 → 服务重载。
实操步骤:准备 GlobalSign 证书、私钥与 fullchain(命令可直接执行)
先建立统一目录并收紧权限:mkdir -p /opt/ssl/example.com && chmod 700 /opt/ssl/example.com。把 GlobalSign 下发的 example.com.crt、example.com.key、中间证书 gs_intermediate.crt 放入目录。合并 fullchain:cat example.com.crt gs_intermediate.crt > fullchain.crt。若 CA 直接给 PFX,可跳过导出;若只有 PEM,则导出 PKCS12:openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in fullchain.crt -certfile gs_intermediate.crt -name tomcat -passout pass:ChangeMe123。检查容器:openssl pkcs12 -info -in example.com.pfx -noout,应看到 MAC verified OK 和证书链。检查域名与有效期:openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName,确认 SAN 含 DNS:example.com,到期时间不超过 398 天。校验私钥匹配:openssl x509 -in example.com.crt -noout -modulus | openssl md5 与 openssl rsa -in example.com.key -noout -modulus | openssl md5 的输出必须一致。最后设权限:chown tomcat:tomcat example.com.pfx && chmod 600 example.com.pfx。若输出 unable to load private key,先确认私钥未加密或提供 -passin。
配置示例:Tomcat 8.5/9/10 使用 PKCS12 启用 8443
编辑 $CATALINA_BASE/conf/server.xml,在 Service 内加入或替换 Connector。下面配置可直接改为你的路径与密码:
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
maxThreads='150' SSLEnabled='true' scheme='https' secure='true'>
<SSLHostConfig protocols='TLSv1.2,TLSv1.3'>
<Certificate certificateKeystoreFile='/opt/ssl/example.com/example.com.pfx'
certificateKeystorePassword='ChangeMe123'
certificateKeystoreType='PKCS12'
certificateKeyAlias='tomcat' />
</SSLHostConfig>
</Connector>
protocols 建议至少保留 TLSv1.2,Java 11+ 可加 TLSv1.3;不要只写 TLS。若使用 Tomcat 10.1,Connector 包名可能为 org.apache.coyote.http11.Http11NioProtocol 仍可用,但需确认依赖版本。密码含特殊字符时,XML 中要转义 & 为 &,或改用 certificateKeystorePassword 外部属性。修改后先校验 XML:xmllint --noout conf/server.xml;再重启:$CATALINA_HOME/bin/shutdown.sh && $CATALINA_HOME/bin/startup.sh。查看日志 logs/catalina.out,出现 Server startup in 且无 SSLException 才算加载成功。生产环境建议把 8080 重定向到 8443,并限制 certificateKeystoreFile 仅 tomcat 用户可读。
老版本 Tomcat:keytool 导入 JKS 与 Connector 配置
Tomcat 7/8.0 或仍使用 JKS 的环境,可把 PFX 转成 JKS。命令中源别名必须与 PFX 内别名一致:keytool -importkeystore -srckeystore example.com.pfx -srcstoretype PKCS12 -srcstorepass ChangeMe123 -srcalias tomcat -destkeystore example.com.jks -deststoretype JKS -deststorepass ChangeMe456 -destkeypass ChangeMe456 -alias tomcat。若提示 Alias <tomcat> does not exist,先用 keytool -list -v -keystore example.com.pfx -storetype PKCS12 -storepass ChangeMe123 查别名。导入后验证链长度:keytool -list -v -keystore example.com.jks -storepass ChangeMe456 | grep -E 'Alias|Entry type|Certificate chain length',正常应显示 Certificate chain length: 2 或 3。老 Connector 配置:
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
SSLEnabled='true' scheme='https' secure='true'
keystoreFile='/opt/ssl/example.com/example.com.jks'
keystorePass='ChangeMe456' keystoreType='JKS'
clientAuth='false' sslProtocol='TLS' />
注意 keystorePass 与 keyPass 在 JKS 中可能不同;若私钥密码与库密码不一致,需加 keyPass。Tomcat 8.5+ 也支持 JKS,但官方更推荐 PKCS12。JKS 迁移后若报 java.security.UnrecoverableKeyException: Cannot recover key,优先检查 keyPass。续期时重新执行导入并覆盖 JKS,再重启 Tomcat;不要只替换 PFX 而 Connector 仍指向旧 JKS。
对比表格:PKCS12 与 JKS、Tomcat 版本与验证命令
选择格式时,优先看 Tomcat 版本和运维习惯。PKCS12 是跨平台标准容器,OpenSSL、Java、Tomcat 8.5+ 都支持;JKS 是 Java 旧格式,兼容老 Connector,但密码和别名处理更易出错。下表用于快速决策:
| 对比项 | PKCS12/PFX | JKS |
|---|---|---|
| Tomcat 8.5+ 推荐 | 是,直接配 certificateKeystoreType=’PKCS12′ | 可用,但非首选 |
| 文件识别 | openssl pkcs12 -info -in a.pfx -noout | keytool -list -v -keystore a.jks |
| 密码模型 | 容器密码,通常同时保护私钥 | storepass 与 keypass 可能不同 |
| 别名要求 | certificateKeyAlias 指向含私钥条目 | Connector 默认 tomcat,需与 alias 一致 |
| 转换命令 | openssl pkcs12 -export … | keytool -importkeystore … |
| 典型报错 | Invalid keystore format / password was incorrect | Cannot recover key / alias does not exist |
Tomcat 版本对应关系也要注意:8.5/9/10 用 SSLHostConfig + Certificate;7/8.0 用 keystoreFile、keystorePass。验证命令统一用 openssl s_client -connect 127.0.0.1:8443 -servername example.com -showcerts </dev/null,返回 Verify return code: 0 (ok) 才算链完整。公有证书有效期最长 398 天,Let’s Encrypt 90 天,建议在到期前 30 天完成续期并回归验证。
常见错误排查:真实报错与逐条修复
下面按报错原文给出修复路径。1)curl: (60) SSL certificate problem: unable to get local issuer certificate:服务端链缺中间证书。把 GlobalSign 中间证书合并进 fullchain 后重新导出 PFX,或确认 Certificate chain length 至少为 2。2)java.security.cert.CertPathValidatorException: PKIX path building failed:Java 客户端信任库没有对应根证书,或服务端链不完整。先用 keytool -printcert -sslserver example.com:8443 看链,再决定补服务端链还是导入客户端 truststore。3)keytool error: java.io.IOException: keystore password was incorrect:密码错或 keystoreType 写错。用 openssl pkcs12 -info -in example.com.pfx -noout 验证密码。4)java.io.IOException: Invalid keystore format:PFX 被当成 JKS。把 certificateKeystoreType 改为 PKCS12。5)SSLHandshakeException: No subject alternative names present:证书 SAN 不含访问域名,重新签发或改用正确域名。6)Received fatal alert: certificate_unknown:证书过期、链异常或客户端不信任。用 openssl x509 -in fullchain.crt -noout -dates 查有效期,确认未超过 398 天。
效果验证:openssl、curl、Java debug 与在线扫描
重启后按四层验证。第一层看本地端口与链:openssl s_client -connect 127.0.0.1:8443 -servername example.com -showcerts </dev/null,输出应包含 Verify return code: 0 (ok)、subject=CN = example.com 和完整中间证书。第二层用 curl 模拟真实域名:curl -vI https://example.com:8443 --resolve example.com:8443:127.0.0.1,不应出现 SSL certificate problem。第三层做 Java 客户端自测:java -Djavax.net.debug=ssl:handshake -jar app.jar,日志中应看到 Found trusted certificate 和 Finished,若出现 PKIX path building failed 则回到链和 truststore。第四层用 keytool -printcert -sslserver example.com:8443 检查证书链长度与到期日,并用浏览器或 SSL Labs 扫描协议、SAN、有效期。最后检查续期自动化:确认配置指向新文件、Tomcat 已 reload/restart,且到期日已更新。若返回 verify error:num=21:unable to verify the first certificate,不要继续调客户端,先修服务端 fullchain。
常见问题
Tomcat 8.5/9/10 优先用 PFX/PKCS12,配置 certificateKeystoreType=’PKCS12′ 即可;Tomcat 7/8.0 或历史环境再用 JKS。PFX 跨平台、链和私钥在同一容器,减少密码与别名错配。
先查服务端链是否含中间证书,用 openssl s_client -showcerts 和 keytool -printcert -sslserver;若链完整,再把根证书导入客户端 truststore。不要只替换叶子证书。
确认新 PFX/JKS 覆盖旧文件、server.xml 指向新路径、密码未变;执行 shutdown/startup 或 reload,检查 logs/catalina.out 与 openssl s_client 的到期日。
分别对证书和私钥执行 -modulus | openssl md5,两个 MD5 一致即匹配;PFX 可用 openssl pkcs12 -info 检查 MAC verified OK。
公有 TLS 证书最长 398 天,实际以签发为准;Let’s Encrypt 为 90 天。建议到期前 30 天续期,并重新导入 keystore、重启 Tomcat 后验证链完整。