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

线上常见一幕:运维在 Nginx 里配好证书,自己用 Chrome 打开,锁头绿色,一切正常。结果接口联调时对方用 curl 一请求,报 unable to get local issuer certificate。他第一反应是对方环境有问题,让对方加 -k 跳过验证。其实问题出在自己这边:服务器证书链没配全。
中间证书是怎么被漏掉的
CA 几乎不会用根证书直接签你的域名证书。典型的层级是:根 CA 证书 → 中间 CA 证书 → 你的服务器证书。客户端验证时,要从服务器证书一路追溯到本地信任库里的某个根。
问题在于握手时服务器默认只发自己那一张证书。中间证书去哪找?现代浏览器很勤快,会通过证书里的 AIA(Authority Information Access)扩展去 CA 的服务器下载中间证书,Chrome、Firefox 都有这个缓存和补链机制。所以你在浏览器里看到的是"一切正常"的假象。

curl、OpenSSL、Python requests、多数 Java 客户端没这么勤快。它们只用本地信任库,补不到中间证书,就直接报错。这也是为什么"浏览器能过"从来不是证书配置正确的充分条件。
fullchain 文件里装了什么
ACME 客户端签发的证书通常给你两类文件:一个是只含服务器证书的 cert.pem,另一个是把服务器证书和中间证书拼接在一起的 fullchain.pem(不同客户端文件名可能不同,但思路一致)。
服务器端要用的就是 fullchain。以 Nginx 为例:

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 设备报错的背景故事——发的链不对,老设备找不到能信的根。

什么时候需要关心这件事
一是对外提供 API 或接入第三方支付、推送回调的场景。这些调用方几乎都不是浏览器,链不全必然有人报错,而且报错往往在对方侧,你自己监控发现不了。
二是做双向 TLS(mTLS)或内部 PKI 时。自建 CA 没有 AIA 可补,客户端能不能验通完全取决于服务器发了什么。
三是排查"间歇性证书报错"。如果错误只出现在某些客户端、某些地区,大概率不是证书过期,而是链或 SNI 的问题。可以用 openssl s_client -connect example.com:443 -servername example.com 看服务器实际下发的证书列表,确认中间证书在不在里面。

在 CertbotX 中实践
CertbotX 通过 ACME 自动签发证书时,会把服务器证书与中间证书合成为完整链,再部署到 Agent、EdgeOne 或 CDN,避免"只传了服务器证书"这类断链问题。每次部署都会留下记录,可以在审计日志里查到哪份链、什么时候推到了哪个节点;到期前重新签发后也会用新链整体替换,不会出现新旧中间证书混用的情况。
核验用链接
- Let's Encrypt 官方文档:证书链与交叉签名说明——了解中间证书和链的实际组织方式
- Nginx 官方文档:配置 HTTPS 服务器——
ssl_certificate对证书链顺序的要求 - RFC 8555(ACME 协议)——证书下发格式与 fullchain 的协议背景