浏览器没报错,App 却握手失败:问题多半出在中间证书

服务器只发送了叶子证书而漏掉中间证书时,桌面浏览器常靠缓存和 AIA 下载补齐链条,于是看起来一切正常;但脚本、移动端和部分 API 客户端不会补链,直接报握手或校验错误。本文解释这条链为什么时灵时不灵,以及怎么检查和修好。

本文目录
浏览器没报错,App 却握手失败:问题多半出在中间证书

线上最迷惑的一类 TLS 故障长这样:你自己用浏览器打开网站,小绿锁稳稳的;同事用 curl 一敲,却报 unable to get local issuer certificate。双方都没操作错,只是桌面浏览器替服务器"擦了屁股"。

证书链是怎么回事

CA 一般不会用根证书直接签你的域名证书。根证书离线保管,实际签发工作由中间证书完成。所以一条完整链条是:

你的域名证书(叶子) ← 中间 CA 证书 ← 根 CA 证书

TLS 握手时,服务器应该把叶子证书和所有中间证书一起发过去。根证书不用发——客户端信任库里本来就有,发了也会被忽略。

问题就出在中间证书这一段。很多证书文件下发时,叶子和中间是分开的两个文件,配置 Web 服务器时只指定了叶子证书,链条就断了。

为什么浏览器看不出来

Chrome、Firefox 这类桌面浏览器有两个补链手段:

  1. 缓存:之前访问过同一 CA 签发的其他网站,中间证书可能已经在本地缓存里。
  2. AIA 下载:叶子证书里通常带一个 Authority Information Access 扩展,写着中间证书的下载地址。浏览器发现缺中间证书时,可以自己去拉。

curl、Python 的 requests、Java 客户端、大多数移动端网络库,默认都不做这两件事。链条不完整,校验直接失败。于是就出现了"浏览器正常、程序报错"的经典分裂现场。

还有一点更坑:如果中间证书恰好被你浏览器缓存了,换台新电脑、清一次缓存,故障会"突然出现",看起来像玄学。

怎么确认和修复

浏览器没报错,App 却握手失败:问题多半出在中间证书:DNS ownership verification using a delegated CNAME, shown as a precise handoff between two controlled zones
浏览器没报错,App 却握手失败:问题多半出在中间证书:DNS ownership verification using a delegated CNAME, shown as a precise handoff between two controlled zones查看原图

确认方法很直接:

openssl s_client -connect example.com:443 -servername example.com

看输出里的 Certificate chain 部分。如果只列了一张证书(编号 0),而它不是自签的,那就是缺中间证书。也可以用 openssl verify 配合 -CAfile 做本地校验,但 s_client 能看到服务器实际发送了什么,更贴近现场。

修复就是把中间证书拼回服务器配置里。对 Nginx 来说,ssl_certificate 指向的文件应该包含叶子证书 + 中间证书,顺序是叶子在前:

cat leaf.crt intermediate.crt > fullchain.crt

Let's Encrypt 用户基本不用手工拼——客户端生成的 fullchain.pem 就是拼好的版本,而 cert.pem 只有叶子。用错文件是这个故障最常见的来源。

在 CertbotX 中实践

CertbotX 走 ACME 协议自动签发,签发结果天然包含完整链条,部署到 Agent、EdgeOne 或 CDN 时推送的是 fullchain,不会只推叶子证书。到期前自动重新签发后同样按完整链部署,部署记录里可以查到每次推送的证书内容摘要,排查链问题时有个对照。如果你的域名 DNS 通过 CNAME 委托给 CertbotX 做 DNS-01 验证,换证过程不需要手工干预,也就少了一次"拼错文件"的机会。

几个容易踩的小坑

  • 中间证书会过期,也会轮换。CA 可能换用新的中间证书签发,手工拼链的旧文件就失效了。自动化签发比手工维护省心,主要就省在这里。
  • 多域名、多 CA 混用时,别把 A CA 的中间证书拼到 B CA 的叶子后面,顺序和内容都要对。
  • 交叉签名会让同一张证书存在多条有效路径(比如老根 + 新根),openssl 验证时选的路径和客户端实际走的可能不同,排查时以 s_client 显示的链条为准。

延伸阅读:

← 返回资讯中心