跳到主要内容
基础知识

证书链在线检查怎么做?7 步定位中间证书缺失与信任链断裂(含 OpenSSL 3.x 命令)

证书链在线检查 — 证书链在线检查怎么做?7 步定位中间证书缺失与信任链断裂(含 OpenSSL 3.x 命令)
核心结论

证书链在线检查的本质,是确认服务器在 TLS 握手时是否下发了“叶子证书 + 全部中间证书”;只要少一张中间证书,curl、Java、Android 就会报 unable to get local issuer certificate,而 Chrome 因具备 AIA 自动补链能力仍显示锁标正常。 最快的一条命令:openssl s_client -connect sslgood.com:443 -servername sslgood.com -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE',返回 1 说明只发了叶子证书,正常应为 2–3。 Nginx 必须把 ssl_certificate 指向 fullchain.pem(cat cert.pem chain.pem > fullchain.pem);只写站点证书是最常见的链断裂原因,Apache 2.4.8+ 可用 SSLCertificateFile 直接指向 fullchain。 判定通过的标准输出是 Verify return code: 0 (ok);出现 error 20 多为缺中间证书、error 21 多为顺序错误或缺中间证书、error 10 为证书已过期。 Let's Encrypt 当前默认链为 ISRG Root X1(RSA)与 ISRG Root X2(ECDSA),中间证书为 R10/R11、E5/E6;旧 Android 依赖 DST Root CA X3 交叉签名,2021-09-30 后需同步升级客户端信任库。

证书链在线检查到底在查什么?为什么浏览器正常、接口却报错

问:证书链在线检查到底在查什么?查的不是”证书有没有过期”,而是”客户端能不能从你下发的证书出发,一路走到它本地信任库里的根”。一条完整的链固定是三层:叶子证书(CN=example.com)→ 中间证书(如 Let’s Encrypt R10/R11、DigiCert Global G2)→ 根证书(ISRG Root X1、DigiCert Global Root G2)。服务器只负责下发叶子和中间证书;根证书由客户端本地信任库提供,不需要也不建议下发——据 Let’s Encrypt 文档,多下一张根证书只会让 Certificate 消息多出约 1.5 KB,不解决任何问题。所以一次证书链在线检查真正核对的,就是”服务器实际下发的证书张数与顺序”。

问:为什么浏览器锁标正常,接口却报错?因为 Chrome、Firefox 桌面版实现了 AIA(Authority Information Access,见 RFC 5280 §4.2.2.1)扩展,发现链不完整时会顺着证书里的 caIssuers URL 自动把中间证书下载回来补齐。不做这件事的客户端就直接失败,而服务间调用恰恰大量使用这类客户端。

客户端 是否自动补链(AIA) 缺失中间证书时的真实报错
Chrome / Firefox 桌面版 支持 无报错,问题被掩盖
curl(OpenSSL 3.x 后端) 不支持 curl: (60) SSL certificate problem: unable to get local issuer certificate
Java 8u2xx / 旧版 OkHttp 不支持 unable to verify the first certificate(顺序颠倒时同样报此错)
Python requests(certifi) 不支持 SSLError: certificate verify failed: unable to get local issuer certificate
iOS NSURLSession 不支持 NSURLErrorServerCertificateUntrusted (-1202)

问:最常见的两个根因是什么?其一,Nginx 的 ssl_certificate 只指向站点证书而没有拼接中间证书,握手时 Certificate 消息里只有 1 张证书,客户端无法构建到根的路径。其二,拼接顺序写反:fullchain.pem 必须叶子在前、中间在后,把中间证书放在前面时,Java 8u2xx 及部分旧版 OkHttp 会直接判定链无效。补上中间证书对握手耗时的影响通常不足 1 个 RTT(一张 2048 位 RSA 中间证书约 1.2–1.5 KB),但缺失它会让 SSL Labs 评分从 A 掉到 B。

# Nginx:fullchain.pem 必须是「叶子证书 + 中间证书」的拼接顺序
# 拼接命令(叶子在前):cat example.com.crt ca_intermediate.crt > fullchain.pem
server {
    listen 443 ssl;
    server_name example.com;
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;  # 关键行:不要只写 example.com.pem
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;               # 默认值 TLSv1.2 TLSv1.3(nginx ≥1.23.4)
}

# OpenSSL 3.x 验证:-servername 必须显式带上,否则拿到默认站点证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'      # 期望 2;输出 1 即缺中间证书

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | grep -E '^ *[is]:|Verify return code'
# Verify return code: 21 (unable to verify the first certificate) 即链断裂

问:还有什么容易误判的细节?多站点共用 IP 时如果不带 -servername,openssl s_client 会拿到默认站点的证书,检查结果与实际域名不符,很容易误判为”链正常”。这也是为什么做证书链在线检查时,务必按域名逐一发起 SNI 握手,而不是只测 IP:443。

证书链在线检查的完整实操步骤(6 步可复现)

如果你想自己完整复现一遍证书链在线检查,最少需要 6 条命令:从确认 OpenSSL 版本开始,到抓取链、统计链层数、在本地构建信任链、用 curl 走真实请求路径复核,最后把结果留作基线。下面每一步都可直接复制执行,示例域名为 sslgood.com。

步骤 1:先确认版本与目标。为什么第一步不是直接连接目标?因为 OpenSSL 1.1.1 已于 2023-09-11 结束支持(据 OpenSSL 官方生命周期公告),旧版本在 SNI 传递和 -verify_return_error 的默认行为上与 3.x 存在差异,同一串命令可能得出相反结论。建议 3.0.13+ 或 3.2/3.3 系列。

# 确认版本与编译信息;建议 OpenSSL 3.0.13+ / 3.2 / 3.3
openssl version -a
# 示例输出:OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 30 Jan 2024)

步骤 2:抓取服务器实际发送的证书链。输出中每一对 -----BEGIN CERTIFICATE----- 到 -----END CERTIFICATE----- 就是一张证书,逐张记录 s:(subject)与 i:(issuer),判断相邻两张是否首尾相接。

# -servername 显式传 SNI,否则多域名服务器可能返回默认站点的证书
echo | openssl s_client -connect sslgood.com:443 
  -servername sslgood.com -showcerts 2>/dev/null

步骤 3:统计证书张数,一步判断是否缺中间证书。在步骤 2 的命令后接 grep -c 即可:

echo | openssl s_client -connect sslgood.com:443 -servername sslgood.com 
  -showcerts 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
grep -c 返回值 链构成 典型场景 结论
1 仅叶子证书 Nginx 的 ssl_certificate 只指向域名证书 缺中间证书,Java/Android 客户端大概率报 unable to get local issuer certificate
2 叶子 + 1 张中间证书 绝大多数 DV/OV 证书 最常见,通常正常
3 叶子 + 2 张中间证书 交叉签名,如 Let’s Encrypt 的 ISRG Root X1 + DST Root CA X3 正常,但握手包体积偏大,可按客户端画像裁剪

步骤 4:导出并在本地验证链能否构建。把整链写入 chain.pem,再按 END CERTIFICATE 拆出叶子证书,最后交给 openssl verify 用系统根证书库验证。-untrusted 提供中间证书,-CAfile 提供信任锚。

# 1) 导出服务器下发的完整链
openssl s_client -connect sslgood.com:443 -servername sslgood.com -showcerts 
  </dev/null 2>/dev/null | sed -n '/BEGIN CERTIFICATE/,/END CERTIFICATE/p' > chain.pem
# 2) 拆分:第 1 张为叶子证书,其余为中间证书
awk 'BEGIN{n=0} /BEGIN CERTIFICATE/{n++} {print > (n==1?"leaf.pem":"inter.pem")}' chain.pem
# 3) 本地构建并验证(Debian/Ubuntu 根证书库路径,RHEL 系为 /etc/pki/tls/certs/ca-bundle.crt)
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem leaf.pem
# 期望输出:leaf.pem: OK
# 缺中间证书时的真实报错:
# leaf.pem: error 20 at 0 depth lookup: unable to get local issuer certificate

步骤 5:用 curl 走真实请求路径复核。OpenSSL 的验证结果只代表“链在密码学上可构建”,不代表调用方会成功。curl 7.8x 默认不会通过 AIA(Authority Information Access)自动补链,这一点最贴近后端 HTTP 客户端的实际行为。

# -I 只取响应头;关注输出中的 "SSL certificate verify ok" 与 subject/issuer 两行
curl -vI https://sslgood.com --cacert /etc/ssl/certs/ca-certificates.crt
# 缺链时典型报错:curl: (60) SSL certificate problem: unable to get local issuer certificate

步骤 6:交叉验证并留基线。用 testssl.sh 3.2 或 Qualys SSL Labs 复核,把 issuer、notAfter、链层数写入 CMDB,再把步骤 2–5 做成 CI 任务或 cron,防止证书续期后链配置被覆盖——这是证书链在线检查里最容易被忽略的一环:链断裂往往不是首次部署引入的,而是某次自动续期只替换了叶子证书。

# testssl.sh 3.2:只看协议与证书链,避免全量扫描拖慢 CI
./testssl.sh --protocols --certificate sslgood.com:443
# 定时任务示例:每天 06:00 检查,非 0 退出码即告警
0 6 * * * /usr/bin/openssl s_client -connect sslgood.com:443 -servername sslgood.com 
  -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE' | grep -qx 2 || echo "chain count changed" | mail -s alert ops@example.com

配置与命令示例:OpenSSL、curl、Nginx、Apache、Kubernetes 具体参数

同一个 fullchain.pem 在 OpenSSL 里验证通过,为什么部署到 Nginx 后浏览器仍然报“证书链不完整”?原因是校验端与部署端的信任锚不同:openssl s_client 默认不因验证失败而返回非 0 退出码,而浏览器会严格校验到根。据 OpenSSL 3.x 手册页(s_client(1)),必须显式加上 -verify_return_error 才能让验证失败变成可捕获的退出码。这是把证书链在线检查写进监控脚本的前提。

1)OpenSSL 3.x 强制校验(可脚本化告警):-servername 必须给,否则 SNI 站点会返回默认证书;</dev/null 避免交互挂起。OpenSSL 3.x 默认 -verify_depth 100,一般无需调整。

# 强制校验:链有问题时退出码非 0(OpenSSL 1.1.1 / 3.x 通用)
openssl s_client -connect sslgood.com:443 -servername sslgood.com 
  -verify_return_error 
  -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null

# 检查完整链并输出每张证书的 subject/issuer,定位缺失的中间证书
openssl s_client -connect sslgood.com:443 -servername sslgood.com 
  -showcerts /dev/null | openssl crl2pkcs7 -nocrl -certfile /dev/stdin 
  | openssl pkcs7 -print_certs -noout

# 写入 cron / 监控脚本:失败即告警
if ! openssl s_client -connect sslgood.com:443 -servername sslgood.com 
     -verify_return_error -CAfile /etc/ssl/certs/ca-certificates.crt 
     /dev/null 2>&1; then
  echo "ALERT: certificate chain verification failed on sslgood.com"
fi

证书还没上线时,用 curl 的 --resolve 指向预发 IP 提前验证,比上线后再排查便宜得多:

curl -vI --resolve sslgood.com:443:203.0.113.10 https://sslgood.com/ 2>&1 | grep -E "SSL certificate|subject|issuer"

2)Nginx 1.20+ 推荐配置:ssl_certificate 必须指向叶子+中间的 fullchain,ssl_trusted_certificate 单独指向中间证书(仅供 OCSP Stapling 与客户端校验使用,不下发给客户端)。ssl_stapling 与 ssl_stapling_verify 默认均为 off。

# fullchain.pem = 叶子证书 + 中间证书(顺序不能反)
cat cert.pem chain.pem > fullchain.pem

# nginx.conf server 块
ssl_certificate           /etc/nginx/ssl/fullchain.pem;   # 下发给客户端的完整链
ssl_certificate_key       /etc/nginx/ssl/privkey.pem;
ssl_trusted_certificate   /etc/nginx/ssl/chain.pem;       # 供 OCSP Stapling 校验
ssl_protocols             TLSv1.2 TLSv1.3;
ssl_stapling              on;
ssl_stapling_verify       on;   # 默认 off,开启后必须能构建到根的信任链
# ssl_stapling_responder 留空:走证书内嵌的 OCSP URL

若 ssl_trusted_certificate 未配置或指向错误文件,nginx -t 会输出 "ssl_stapling" ignored, issuer certificate not found 一类告警,实际 stapling 状态为“未装订”,用 openssl s_client -connect ... -status </dev/null | grep -i "OCSP Response Status" 可验证是否真的返回了 successful。

3)Apache 2.4.8+ 写法:SSLCertificateChainFile 自 2.4.8 起已废弃(仍兼容),新部署直接把中间证书拼进 SSLCertificateFile;SSLCACertificateFile 用于双向 TLS 的客户端 CA,不要和服务器链混用,混用会让部分客户端把中间证书误判为受信 CA。

SSLCertificateFile      /etc/httpd/ssl/fullchain.pem   # 叶子 + 中间
SSLCertificateKeyFile   /etc/httpd/ssl/privkey.pem
# SSLCertificateChainFile 已废弃,2.4.8+ 无需再写
# SSLCACertificateFile 仅用于 mTLS 客户端 CA 验证

4)Kubernetes Ingress:Secret 的 tls.crt 必须是“叶子 + 中间”的 PEM 拼接,顺序反了会导致部分客户端只拿到中间证书。改完 Secret 后需重启控制器才会重新加载。

kubectl create secret tls app-tls --cert=fullchain.pem --key=privkey.pem -n prod
kubectl rollout restart deploy/<nginx-ingress-controller> -n ingress-nginx

5)私钥与证书匹配性校验:两侧 modulus 的 MD5 必须完全一致,不一致时 Nginx 启动报 SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:X509_check_private_key:key values mismatch)。RSA 证书用下面两条;ECC 证书改用 openssl pkey -pubout 比对公钥。

openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem   | openssl md5   # 两行输出须一致
平台 链文件参数 关键坑点
Nginx 1.20+ ssl_certificate 指向 fullchain;ssl_trusted_certificate 指向 chain 两者指反 → 中间证书下发给客户端、OCSP 校验链缺失
Apache 2.4.8+ 仅 SSLCertificateFile(含链) 继续写 SSLCertificateChainFile 属冗余;SSLCACertificateFile 不可混用
K8s Ingress Secret tls.crt = 叶子+中间 顺序颠倒、忘记 rollout restart 导致旧链继续生效

方案选型对比:在线工具、openssl、testssl.sh、curl 该怎么搭配用

证书链检查没有”银弹”,工具口径不同结论就会不同。选型前先明确一件事:你要回答的是”链在 OpenSSL 眼里完整吗”,还是”在浏览器/Java/客户真实调用路径里完整吗”。前者用 openssl 秒级判断,后者必须换工具复核。

工具 是否 AIA 自动补链 覆盖客户端口径 典型耗时 适用场景
openssl s_client(3.0+) 否 OpenSSL 信任库 <1s 快速判断链是否完整
curl 7.8x+ 否 OpenSSL / GnuTLS / SecureTransport <1s 复核真实调用路径
Qualys SSL Labs 是 浏览器口径 30–90s 对外评分与兼容性报告
testssl.sh 3.2 否 多协议多 cipher 1–3 min 内网批量与合规扫描
Java keytool / openssl verify 否 JVM cacerts <1s 排查 Java 接口 PKIX 报错
Chrome DevTools Security 面板 是 Chrome / Firefox 即时 用户侧现象复现

“是否 AIA 自动补链”这一列是分水岭。据 RFC 5280 §4.2.2.1,证书可携带 Authority Information Access 扩展指向签发者证书;浏览器和 SSL Labs 会按 AIA 去补拉中间证书,所以服务器漏发中间证书时它们仍可能显示绿锁,而 OpenSSL、curl、Java 默认不补链,直接报 unable to get local issuer certificate。这正是”浏览器正常但 App 报错”的根因。

两条命令足够覆盖日常变更后的 30 秒判断:

# 1) 看服务端实际下发了哪几层,以及验证结果(OpenSSL 3.0+)
openssl s_client -connect example.com:443 -servername example.com 
  -showcerts -verify_return_error </dev/null 2>&1 
  | grep -E 'Verify return code|^ *[0-9]+ s:|^ *i:'

# 2) 用真实 HTTP 路径复核(curl 7.88+,--cert-status 可选 OCSP stapling)
curl -vI https://example.com --max-time 10 2>&1 | grep -E 'SSL certificate|subject:|issuer:'

Verify return code: 0 (ok) 才代表该信任库认可整条链;返回 20 (unable to get local issuer certificate) 说明服务端少发中间证书,或你本机 CA 库缺失。注意 -showcerts 打印的是服务端下发的证书,不包含 AIA 补拉结果,这就是它和 SSL Labs 结论可能相反的原因。若要把结果落盘再逐张校验,可把输出重定向后用 openssl crl2pkcs7 -nocrl -certfile chain.pem | openssl pkcs7 -print_certs -noout 列出 subject/issuer 配对关系。

下发几层证书最合适?

下发层数 内容 握手体积 结论
1 层 仅叶子证书 约 1.2–1.5 KB 非浏览器客户端普遍失败,不可用
2 层 叶子 + 1 张中间证书 约 2.5–3 KB 绝大多数场景最优解
3 层 含交叉签名中间证书 约 4–4.5 KB 兼容旧 Android(7.0 以下)时可接受
4 层及以上 额外附带根证书 +1.2–1.4 KB 纯冗余,无收益,不建议

根证书绝不能下发:客户端本就内置根证书,多发的根证书会被部分实现忽略,白白增加握手包体积,还可能触发某些合规扫描的”证书链过长”告警。

信任库口径不同,结论就不同

同一个域名,四套信任库可以给出四种答案,检查时必须说清用的是哪一套:

  • Debian/Ubuntu:/etc/ssl/certs/ca-certificates.crt,由 update-ca-certificates 更新;
  • RHEL/CentOS:/etc/pki/tls/certs/ca-bundle.crt,由 update-ca-trust 更新;
  • Python requests:用 certifi 包,路径由 python -c "import certifi; print(certifi.where())" 输出;
  • JVM:$JAVA_HOME/lib/security/cacerts,默认口令 changeit。

据 Let’s Encrypt 文档,其证书链曾因 DST Root CA X3 过期与 ISRG Root X1 交叉签名切换,导致旧 Android 设备与部分 Java 运行时同时出现信任问题——这说明”证书链在线检查”的结论必须绑定信任库版本才可信。

持续监控与成本怎么权衡

一次性检查用前两条命令即可;需要无人值守时,用 blackbox_exporter 0.25+ 的 probe_ssl_earliest_cert_expiry 指标接入 Prometheus,按剩余 <30 天告警:

# blackbox.yml 片段:启用 HTTPS 探针的证书过期指标
modules:
  https_2xx:
    prober: http
    timeout: 5s
    http:
      preferred_ip_protocol: ip4
      valid_status_codes: [200]

成本上,openssl、curl、testssl.sh(GPLv2)、blackbox_exporter 均为零成本自建;SSL Labs 免费公开接口有速率限制,企业版按年计费;商业证书链监控 SaaS 常见报价为每域名每月数十元到上百元,适合域名数量多、无人值守的团队。对外出具报告选 SSL Labs 或 testssl.sh 存档,日常排障选 openssl + curl 两条命令——把工具口径写进检查记录,比纠结”哪个工具最准”更有价值。

同一张证书为什么在浏览器、Java、Android 上表现不一样?

因为每个客户端读的根本不是同一本”信任簿”。证书链校验 = 叶子证书 → 中间证书 → 根证书逐级验签,而”根证书在不在本地信任库””中间证书没下发时会不会自动去补”这两件事,各运行时策略完全不同。同一张证书在浏览器能开、在 App 里报错,几乎都落在这两点上。

运行时 信任库来源 是否自动补链(AIA Fetch) 典型报错
OpenSSL 3.x / curl /etc/ssl/certs/ca-certificates.crt 或 –cacert 指定 默认否(s_client 不抓 AIA) verify error:num=21:unable to verify the first certificate
Java (SunJSSE) $JAVA_HOME/lib/security/cacerts 否 PKIX path building failed
Android 7.0+ 系统 CA + network_security_config.xml 否 Trust anchor for certification path not found
Python requests certifi 包内的 cacert.pem 否 unable to get local issuer certificate
iOS / macOS 系统信任库(随 OS 版本更新) NSURLSession 否,Safari 是 NSURLErrorServerCertificateUntrusted(-1202)

Java:cacerts 是一份随 JDK 版本漂移的快照。JDK 8u261 起 Oracle 从 cacerts 中移除了一批过期根证书,JDK 11/17/21 的内置根集也各不相同,所以”开发机 JDK 17 能连、线上 JDK 8 报 PKIX path building failed”很常见。先确认根在不在:

# 列出 cacerts 中所有含 isrg 的条目,确认 ISRG Root X1 是否存在
# 默认口令 changeit,默认路径 $JAVA_HOME/lib/security/cacerts(JDK 8~21 通用)
keytool -list -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit | grep -i isrg

# 缺失时导入(先下载 https://letsencrypt.org/certs/isrgrootx1.pem)
keytool -importcert -alias isrgrootx1 -file isrgrootx1.pem 
  -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit -noprompt

Android:targetSdkVersion ≥ 24 就不认用户装的 CA 了。自 Android 7.0(API 24)起,应用默认只信任系统 CA,手动装到”用户凭据”里的 CA 对 targetSdk ≥ 24 的应用不生效——这是自签或私有 CA 场景下”浏览器能开、App 打不开”的头号原因。要在 App 内显式声明信任锚:

<!-- res/xml/network_security_config.xml,Android 7.0+ 生效 -->
<network-security-config>
  <base-config>
    <trust-anchors>
      <certificates src="system"/>   <!-- 系统 CA -->
      <certificates src="user"/>     <!-- 显式信任用户安装的 CA,仅私有 CA 场景需要 -->
    </trust-anchors>
  </base-config>
</network-security-config>
<!-- AndroidManifest.xml: <application android:networkSecurityConfig="@xml/network_security_config"> -->

Python:信任库来自 certifi,一行升级就能换根库。requests 默认用 certifi 打包的 cacert.pem,pip install -U certifi 即可刷新;企业内网 CA 则用环境变量指向合并后的 PEM:

python -c "import certifi; print(certifi.where())"   # 查看当前使用的 PEM 路径
pip install -U certifi                                # 更新根库
cat certifi路径 cacert.pem corp-ca.pem > combined.pem
export REQUESTS_CA_BUNDLE=/path/combined.pem          # requests 专用
export SSL_CERT_FILE=/path/combined.pem               # 影响 ssl 模块/urllib 等

iOS/macOS:系统信任库随 OS 更新,NSURLSession 不做 AIA 补链。服务器漏发中间证书时,NSURLSession 直接抛 NSURLErrorServerCertificateUntrusted(-1202);而 Safari 打开同一域名往往能成功,因为它走系统级补链逻辑去抓取中间证书。所以”用浏览器试过没问题”不能作为 App 可用的证据。

历史坑:交叉签名链的到期。Let’s Encrypt 早期中间证书 R3 由 ISRG Root X1 签发,并通过 DST Root CA X3 交叉签名兼容旧设备。据 Let’s Encrypt 官方公告,DST Root CA X3 已于 2021-09-30 到期,仍停留在旧系统/旧 JDK 的客户端会报 trust anchor not found,只能升级系统根库或改用其他 CA 的交叉签名链。这也解释了为什么”证书没过期、链看着也全”却仍握手失败。

因此一次证书链在线检查至少要在三个面各验一次:openssl s_client -connect example.com:443 -servername example.com -showcerts -CAfile /etc/ssl/certs/ca-certificates.crt(OpenSSL 信任库视角)、curl -vI https://example.com(HTTP 栈视角)、以及目标运行时的 JVM 或 Android 真机(用户视角)。三者结论不一致,本身就是最有力的定位线索。

常见错误与真实报错信息排查清单

问:curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate,一定是服务端少发了中间证书吗?

九成是。该错误的含义是:客户端拿到叶子证书后,无法沿着服务端下发的证书链回溯到本地信任库中的根证书。别急着改 nginx,先用一条命令数清楚服务端到底发了几张证书——这也是证书链在线检查里最快的一次分诊:

# 统计 fullchain.pem 中的证书张数(一张叶子 + N 张中间证书)
grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/fullchain.pem
# 输出 1  → 只下发了叶子证书,中间证书缺失,改服务端 ssl_certificate 指向 fullchain.pem
# 输出 ≥2 → 链已下发,问题在客户端信任库,转下一步

Let’s Encrypt 签发的 cert.pem 只有叶子证书,fullchain.pem 才是叶子+中间(默认含 R3/E1 等中间证书),把 ssl_certificate 写成 cert.pem 是最常见的翻车点。若张数 ≥2 仍报错,查客户端 CA bundle 是否过旧:CentOS 7 上执行 yum update ca-certificates && update-ca-trust extract 重建 /etc/pki/tls/certs/ca-bundle.crt;Debian/Ubuntu 对应 update-ca-certificates,默认 bundle 为 /etc/ssl/certs/ca-certificates.crt。

问:openssl verify 输出的 error 10 / 20 / 21 分别指向什么?

OpenSSL 3.x 的 verify 用 -untrusted 传中间证书、-CAfile 传根证书,断点会精确到某一层:

# OpenSSL 3.x(3.0.0 起默认安全级别 SECLEVEL=2,SHA-1 旧链会额外报错)
openssl verify -CAfile root.pem -untrusted chain.pem leaf.pem
# error 20 at 0 depth lookup: unable to get local issuer certificate → 缺中间证书
# error 21 at 0 depth lookup: unable to verify the first certificate → 链顺序错(中间证书排在叶子前面)
# error 10 at 0 depth lookup: certificate has expired → 有效期问题,用下一条核对
openssl x509 -noout -dates -in leaf.pem   # 比对 notBefore / notAfter

问:Java 抛 PKIX path building failed: unable to find valid certification path to requested target 怎么定位?

两种可能:服务端缺中间证书,或 JVM 的 cacerts(默认 $JAVA_HOME/lib/security/cacerts,默认口令 changeit)里没有对应根。打开握手日志一眼看穿:

java -Djavax.net.debug=ssl:handshake -jar app.jar 2>&1 | grep -A3 'Certificate chain length'
# Certificate chain length: 1 → 服务端未下发中间证书
# Certificate chain length: 2 → 链完整,缺的是 JVM 里的根
keytool -list -cacerts -storepass changeit | grep -i 'your-ca'

问:Chrome 的 NET::ERR_CERT_AUTHORITY_INVALID 和 nginx 启动报错怎么区分?

浏览器报 ERR_CERT_AUTHORITY_INVALID/ERR_CERT_INVALID,通常是自签根未导入客户端、链中含过期根,或中间证书与叶子证书不属同一签发关系——用 openssl verify -CAfile root.pem -untrusted chain.pem leaf.pem 逐层验。而 nginx 启动即失败的两条报错完全是本地配置问题:

# 报错 A:私钥与证书不配对(续期只换证书没换 key 的典型症状)
# nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:
#   x509 certificate routines:X509_check_private_key:key values mismatch)
openssl x509 -noout -modulus -in cert.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem | openssl md5   # 两行 MD5 必须完全一致

# 报错 B:PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line)
# 说明 fullchain.pem 混入非 PEM 内容(CRLF、重复 Bag Attributes、链被截断),逐张打印验证
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
真实报错 首要根因 一条命令定位
curl: (60) unable to get local issuer certificate 服务端缺中间证书 / 客户端 CA 库过旧 grep -c 'BEGIN CERTIFICATE' fullchain.pem
error 20 at 0 depth lookup 缺中间证书 openssl verify -untrusted chain.pem leaf.pem
error 21 at 0 depth lookup 链顺序错误 同上,检查 chain.pem 内顺序
error 10 at 0 depth lookup 证书过期 openssl x509 -noout -dates -in leaf.pem
PKIX path building failed 缺中间证书或 JVM 缺根 -Djavax.net.debug=ssl:handshake 看 chain length
NET::ERR_CERT_AUTHORITY_INVALID 根不受信 / 签发关系不匹配 openssl verify -CAfile root.pem -untrusted chain.pem leaf.pem
X509_check_private_key:key values mismatch 私钥与证书不配对 openssl x509 -noout -modulus | openssl md5
PEM_read_bio_X509_AUX() failed PEM 文件被污染或截断 openssl crl2pkcs7 -nocrl -certfile ... | openssl pkcs7 -print_certs -noout

效果验证:如何确认证书链已修复并持续生效

第一道验证:链是否闭合。最省事的判据只有一行输出,据 OpenSSL 官方文档,s_client 在握手后会打印对端证书的校验结果,0 表示整条链已锚定到本地信任库:

# OpenSSL 1.1.1 / 3.x 通用;</dev/null 防止卡在交互输入
openssl s_client -connect sslgood.com:443 -servername sslgood.com /dev/null 
  | grep 'Verify return code'
# 期望输出:Verify return code: 0 (ok)
# 若加 -verify_return_error,非 0 时命令直接以非 0 退出码结束,便于写进 CI 门禁

任何非 0 值都说明链或有效期仍有问题,返回码含义来自 OpenSSL 的 x509_vfy.h(对应 RFC 5280 的路径校验失败原因):

返回码 OpenSSL 输出 典型成因
2 unable to get issuer certificate 链顺序错误,或中间证书重复下发
10 certificate has expired 叶子或中间证书过期(中间证书常被忽略)
19 self-signed certificate in chain 误把自签根证书拼进 fullchain
20 unable to get local issuer certificate 服务端漏发中间证书
21 unable to verify the first certificate 链中缺中间证书,最常见的“断裂”
62 hostname mismatch SNI 或证书 SAN 与域名不符

第二道验证:数链层数并看签发者。证书链在线检查只告诉你“通不通”,还要确认“发了几张”。正常应为 2 张(叶子 + 中间)或 3 张(含交叉签名中间证书);只剩 1 张即中间证书丢失:

# 链上证书张数
openssl s_client -showcerts -connect sslgood.com:443 -servername sslgood.com /dev/null 
  | grep -c 'BEGIN CERTIFICATE'
# 期望:2 或 3

# 叶子证书的 issuer 应指向中间 CA(如 R11),而非直接指向根
openssl s_client -connect sslgood.com:443 -servername sslgood.com /dev/null 
  | openssl x509 -noout -subject -issuer -dates
# 期望形如:issuer=C=US, O=Let's Encrypt, CN=R11

第三道验证:在目标运行时上复测。OpenSSL 通过不代表客户端通过,各运行时信任库不同:

curl -vI https://sslgood.com 2>&1 | grep -i 'SSL certificate verify'   # 期望 ok
keytool -printcert -sslserver sslgood.com:443 | grep -E 'Owner|Issuer'  # JDK 实际下发的链
# Android / iOS 必须用真机打开业务页面,模拟器信任库与真机不一致

配置层验证。改完 Nginx 先校验语法再重载,用 reload 而非 restart,避免既有连接被切断:

nginx -t                      # 必须返回 syntax is ok / test is successful,失败切勿 reload
systemctl reload nginx        # 平滑重载,worker 换新、master 不变
ss -tlnp | grep ':443'        # master PID 应与重载前一致

监控层验证。一次通过不等于持续生效。blackbox_exporter 0.25+ 默认 probe 超时 120s,建议显式缩短并禁用跳过校验:

# blackbox.yml
modules:
  https_chain:
    prober: http
    timeout: 10s
    http:
      preferred_ip_protocol: ip4
      tls_config:
        insecure_skip_verify: false   # 关键:不要为了“消除告警”关掉
# Prometheus 告警规则(30 天阈值可按需调整)
- alert: TLSChainOrExpiryBroken
  expr: probe_ssl_earliest_cert_expiry - time() < 30 * 24 * 3600
  for: 1h

同时用 testssl.sh 定时输出 JSON,比对 chain length 字段,链层数下降即说明 fullchain 被覆盖成了单证书。

回归与留痕。把修复前后的完整 s_client 输出、SHA-256 指纹与验证时间写入变更单,并让续期自动重跑上述步骤:

openssl x509 -noout -fingerprint -sha256 -in /etc/letsencrypt/live/sslgood.com/fullchain.pem
# 据 Let's Encrypt 文档,--deploy-hook 仅在证书真正续期后触发,可安全挂载验证与重载
certbot renew --deploy-hook "systemctl reload nginx"

按 Mozilla Server Side TLS 指南的建议,中间证书应随叶子一并下发、根证书不要下发——续期脚本上线后每次自动复跑前六步,就能避免 fullchain.pem 被误配成 cert.pem 导致的信任链断裂复发。

两者口径不同。浏览器(Chrome/Firefox)支持 AIA 自动补链,即使服务器漏发中间证书也可能显示锁标正常,属于“用户视角”;openssl s_client、curl、testssl.sh 不做补链,属于“服务端真实下发视角”。排查服务间调用问题时,应以 openssl 与 curl 的结果为准,浏览器结果只作参考。

因为两者用的信任库不同。openssl 用的是系统 CA(如 /etc/ssl/certs/ca-certificates.crt),Java 用的是 $JAVA_HOME/lib/security/cacerts。若服务端链完整但 JVM 里没有对应根证书(例如 JDK 8u261 之后移除了部分旧根),仍会失败。用 keytool -list -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit | grep -i 根名称 确认后再决定是补链还是导入根证书。

不需要。按 RFC 8446 与通用实践,服务器下发“叶子证书 + 全部中间证书”即可,根证书应由客户端信任库提供。额外下发根证书会让握手包多出约 1.2–1.4 KB,没有收益,部分严格实现的客户端还会忽略它。

先执行 openssl s_client -connect 域名:443 -servername 域名 -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE',若返回 1,说明只下发了叶子证书。把中间证书与站点证书拼接成 fullchain.pem(叶子在前、中间在后),把 Nginx 的 ssl_certificate 指向它,nginx -t 后 systemctl reload nginx,再复测到 Verify return code: 0 (ok)。

绝大多数场景 2 层(叶子 + 1 张中间证书)最合适,握手体积约 2.5–3 KB。只有在需要兼容旧 Android 等设备、必须携带交叉签名中间证书时才用 3 层,体积约 4–4.5 KB。超过 4 层会明显增加握手开销,通常意味着链配置有冗余,应清理。

临时排查或对外出具报告,用 Qualys SSL Labs 这类在线工具,30–90 秒能拿到浏览器口径的评分与兼容性结论;内网资产、批量域名或需要接入 CI 的场景,用 testssl.sh 3.2 或 openssl + curl 脚本更合适,可离线运行、可版本化、可设定退出码。两者不是替代关系,建议在线工具做基准、本地脚本做回归。

不包含。Let's Encrypt 生成的 fullchain.pem 通常是叶子证书加一张中间证书(如 R10/R11 或 E5/E6),根证书 ISRG Root X1/X2 由客户端信任库提供。用 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout 可以直接列出文件里到底有几张证书、分别是谁签发的。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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