证书链不完整:如何诊断并修复缺失的中间证书(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 failed | TrustStore 缺 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 证书。