为什么浏览器能开、curl 却报证书错误:聊聊 fullchain 和中间证书

很多人配证书时只放了服务器证书,结果浏览器访问正常,curl 或 Java 客户端却报 unable to get local issuer certificate。根源在于中间证书没有随握手一起下发。本文解释 fullchain 文件里到底装了什么,以及什么时候必须用它。

本文目录
为什么浏览器能开、curl 却报证书错误:聊聊 fullchain 和中间证书

线上常见一幕:运维在 Nginx 里配好证书,自己用 Chrome 打开,锁头绿色,一切正常。结果接口联调时对方用 curl 一请求,报 unable to get local issuer certificate。他第一反应是对方环境有问题,让对方加 -k 跳过验证。其实问题出在自己这边:服务器证书链没配全。

中间证书是怎么被漏掉的

CA 几乎不会用根证书直接签你的域名证书。典型的层级是:根 CA 证书 → 中间 CA 证书 → 你的服务器证书。客户端验证时,要从服务器证书一路追溯到本地信任库里的某个根。

问题在于握手时服务器默认只发自己那一张证书。中间证书去哪找?现代浏览器很勤快,会通过证书里的 AIA(Authority Information Access)扩展去 CA 的服务器下载中间证书,Chrome、Firefox 都有这个缓存和补链机制。所以你在浏览器里看到的是"一切正常"的假象。

为什么浏览器能开、curl 却报证书错误:聊聊 fullchain 和中间证书:an ACME request being validated at separate stations and turned into a new deployable artifact while private key material remains at its origin
为什么浏览器能开、curl 却报证书错误:聊聊 fullchain 和中间证书:an ACME request being validated at separate stations and turned into a new deployable artifact while private key material remains at its origin查看原图

curl、OpenSSL、Python requests、多数 Java 客户端没这么勤快。它们只用本地信任库,补不到中间证书,就直接报错。这也是为什么"浏览器能过"从来不是证书配置正确的充分条件。

fullchain 文件里装了什么

ACME 客户端签发的证书通常给你两类文件:一个是只含服务器证书的 cert.pem,另一个是把服务器证书和中间证书拼接在一起的 fullchain.pem(不同客户端文件名可能不同,但思路一致)。

服务器端要用的就是 fullchain。以 Nginx 为例:

为什么浏览器能开、curl 却报证书错误:聊聊 fullchain 和中间证书:a new certificate version moving from its source to several edge appliances while the previous working version remains ready for rollback
为什么浏览器能开、curl 却报证书错误:聊聊 fullchain 和中间证书:a new certificate version moving from its source to several edge appliances while the previous working version remains ready for rollback查看原图
ssl_certificate     /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;

配置后,握手时服务器会把整条链(除根之外)一起发出去,客户端拼到本地根就能验证通过。根证书不需要发,发了也没用——客户端只信自己库里已有的根,你发过去的根它不看。

几个容易踩的小坑:

  • 拼接顺序有讲究:服务器证书在前,中间证书在后。顺序反了,有些客户端直接解析失败。
  • 多中间证书的情况:链可能不止一层,少一层都算断链。换 CA 或 CA 轮换中间证书后,旧 fullchain 可能失效。
  • 交叉签名:某些 CA 的证书存在两条验证路径,服务器发哪条链决定了客户端走哪条路。这就是 2021 年 Let's Encrypt DST Root CA X3 到期时一堆旧 Android 设备报错的背景故事——发的链不对,老设备找不到能信的根。
为什么浏览器能开、curl 却报证书错误:聊聊 fullchain 和中间证书:an approaching certificate expiry being detected early, followed by a fresh request and a safe replacement before the live connection is interrupted
为什么浏览器能开、curl 却报证书错误:聊聊 fullchain 和中间证书:an approaching certificate expiry being detected early, followed by a fresh request and a safe replacement before the live connection is interrupted查看原图

什么时候需要关心这件事

一是对外提供 API 或接入第三方支付、推送回调的场景。这些调用方几乎都不是浏览器,链不全必然有人报错,而且报错往往在对方侧,你自己监控发现不了。

二是做双向 TLS(mTLS)或内部 PKI 时。自建 CA 没有 AIA 可补,客户端能不能验通完全取决于服务器发了什么。

三是排查"间歇性证书报错"。如果错误只出现在某些客户端、某些地区,大概率不是证书过期,而是链或 SNI 的问题。可以用 openssl s_client -connect example.com:443 -servername example.com 看服务器实际下发的证书列表,确认中间证书在不在里面。

为什么浏览器能开、curl 却报证书错误:聊聊 fullchain 和中间证书:a browser-side endpoint independently inspecting the live TLS connection after deployment and comparing the observed endpoint artifact
为什么浏览器能开、curl 却报证书错误:聊聊 fullchain 和中间证书:a browser-side endpoint independently inspecting the live TLS connection after deployment and comparing the observed endpoint artifact查看原图

在 CertbotX 中实践

CertbotX 通过 ACME 自动签发证书时,会把服务器证书与中间证书合成为完整链,再部署到 Agent、EdgeOne 或 CDN,避免"只传了服务器证书"这类断链问题。每次部署都会留下记录,可以在审计日志里查到哪份链、什么时候推到了哪个节点;到期前重新签发后也会用新链整体替换,不会出现新旧中间证书混用的情况。

核验用链接

← 返回资讯中心