返回文章
排错2026-06-18•4 分钟阅读•CSR.plus 团队

证书链不完整:如何诊断并修复缺失的中间证书(Nginx / Apache)

证书链不完整:如何诊断并修复缺失的中间证书(Nginx / Apache)

开篇直答:绝大多数“证书链错误”并不是证书失效,而是服务器只发送了叶证书、没有发送中间证书。一条命令即可判定:用 openssl s_client -showcerts 数一下握手里返回了几张证书,只有 1 张就是断链。修复方式是把「叶证书 + 中间证书」按叶在前的顺序拼成一个文件:Nginx 让 ssl_certificate 指向它,Apache 2.4.8 及以上把链直接放进 SSLCertificateFile。根证书不需要发送,客户端本地信任库已经预置。

核心概念

三件套:服务器该发什么、不该发什么

组件作用服务器是否应发送
叶证书(end-entity)绑定你的域名是
中间证书(intermediate)连接叶证书与根是(缺失即断链)
根证书(root)客户端信任锚否,客户端已预置

信任链如何工作

客户端只直接信任根证书。你的叶证书由中间证书签发,而中间证书不在客户端信任库里,所以必须由服务器在握手中一并送出,客户端才能构建出「叶 → 中间 → 根」的路径。为什么中间证书必须发:客户端只信任本地根库,缺中间就构不成路径。

为什么“有的浏览器能访问、有的不能”

部分客户端会缓存中间证书,或通过证书的 AIA 扩展去补齐缺失环节,于是掩盖了问题;不做这件事的客户端(较旧的 Android、Java/OpenJDK、curl、Node、监控系统)会立刻失败。服务器端不应依赖客户端自己补全——AIA 补链依赖客户端实现与网络可达性,不可靠。

链的顺序

证书文件内叶在前、中间按签发顺序在后。顺序错会导致部分客户端直接报链错误。

Let's Encrypt 当前链结构

实际部署中 ECDSA 叶证书通常配 ECDSA 中间证书,但跨算法签名在 X.509 中是合法的——真正必须匹配的是签发者与签名,而不是密钥算法。

实操:6 步定位并修复

第 1 步:看服务器实际发了什么

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

数 BEGIN CERTIFICATE 出现次数:1 = 只发了叶证书;2 及以上为正常。

第 2 步:确认缺哪一级 + 看错误码

openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null

返回码 20 = 找不到签发者(缺中间);21 = 无法验证第一张证书;19 = 自签名。

第 3 步:拿到正确的中间证书

从 CA 提供的链包下载,或从叶证书的 Authority Information Access(AIA)扩展里取中间证书地址。不要混用代次:ECDSA 叶证书必须配 ECDSA 中间证书,RSA 配 RSA。用 证书解码器 可快速查看签发者与 AIA。

第 4 步:拼接(叶在前,不含根)

cat leaf.crt intermediate.crt > fullchain.crt

根证书不需要拼进去:客户端本地信任库已经预置,重复发送只会增加握手体积。

第 5 步:配置服务器

Nginx:只有 ssl_certificate 与 ssl_certificate_key 两个指令,没有单独的链指令,中间证书必须拼进同一个文件且叶在前。

ssl_certificate     /etc/ssl/certs/fullchain.crt;
ssl_certificate_key /etc/ssl/private/example.com.key;

Apache 2.4.8+:SSLCertificateChainFile 已移除,链直接拼进 SSLCertificateFile 指向的文件。

Certbot 用户:cert.pem 是仅叶证书(用它就是本 bug 的根源),chain.pem 是仅中间证书,fullchain.pem 才是你要配置的文件。

CDN:CDN 用自己的证书终止 TLS,若只上传叶证书,它会把同样的断链透传给访客。

第 6 步:验证

openssl verify -CAfile root.pem -untrusted intermediate.pem leaf.pem   # 期望 leaf.pem: OK

再用 SSL 站点检测 从外部复测,并用干净的浏览器配置档验证。

排错清单

现象 / 错误码原因处理
verify error:num=20 unable to get local issuer certificate缺中间证书,或客户端本地信任库缺根先查服务器发了几张证书
verify error:num=21 unable to verify the first certificate服务器未发送中间证书拼接 fullchain 并重载
verify error:num=19 self signed certificate用了自签名证书换用公开信任证书
Chrome NET::ERR_CERT_AUTHORITY_INVALID路径构建失败同上,且清缓存后复测
Java PKIX path building failedTrustStore 缺 CA 或中间未返回发完整链;勿只靠浏览器“能打开”判断
curl / Node 报错,浏览器正常浏览器掩盖了问题以 curl 为准修服务器
只在部分 Android 机型报错旧信任库 + 无 AIA 补全发完整链
中间证书没有签发该叶证书链文件里放错了中间证书换成 subject 与叶证书 issuer 一致的那张中间证书
只配置了 cert.pem只发叶证书、没发中间改用 fullchain.pem 并重载
负载均衡/CDN 与源站证书不一致两边链不一致两边都要更新 fullchain

延伸阅读

工具:SSL 站点检测 检测线上链 · 证书解码器 查看签发者与 AIA · 证书与私钥匹配检查 同时确认证书与私钥配对

相关文章:《SSL 证书格式全解》 · 《证书与私钥匹配检查》 · 《ACME HTTP-01 vs DNS-01》

深入阅读:SSL 证书完全指南 · 证书类型对比

常见问题

需要把根证书也拼进 fullchain 吗?

不需要,也不建议。根证书客户端已预置,重复发送只是增加握手体积和混淆。

为什么 Chrome 正常,但 curl / Android / Java 报错?

部分客户端会缓存中间证书或通过 AIA 补齐;不做补全的客户端直接失败。判断标准是 curl,而不是浏览器。

CDN 会掩盖这个问题吗?

不会。CDN 用自己的证书终止 TLS,只上传叶证书会把同样的断链转给访客。

cert.pem、chain.pem、fullchain.pem 有什么区别?

Certbot 目录下:cert.pem 仅叶证书,chain.pem 仅中间证书,fullchain.pem = 叶 + 中间。Nginx/Apache 应使用 fullchain.pem。

Let's Encrypt 迁移到新根后我要做什么?

通常无需手工改配置,客户端会自动拿到新链;但要确保没有在配置里写死(pin)某个中间证书,并确认老客户端信任库包含 ISRG Root X1/X2。

免费 SSL/TLS 工具

数秒内验证并检查你的证书。

相关证书信息

进一步了解如何选择和购买 SSL 证书。