网站配了 HTTPS,浏览器打开自己电脑上一切正常,但同事的手机、客户的安卓机、或者某些接口调用方却报"证书不受信任"。这种"有人能开、有人打不开"的情况,十有八九是证书链不完整造成的。它比"证书过期"更隐蔽,因为本地浏览器有时会自动去补齐缺失的中间证书,把问题掩盖过去,而你的服务器其实并没有把完整的信任链发给客户端。
这篇文章要解决的就是这个问题:讲清楚证书链的组成(根证书、中间证书、服务器证书之间的关系),教你用 openssl s_client 一眼看出链是否完整,然后给出修复方法(把中间证书拼进服务器配置),最后讲怎么验证修复生效。命令都是通用的 OpenSSL,配置示例涵盖 Nginx 和 Apache。
读完你应该能做到两件事:快速判断一个 HTTPS 服务是不是在"链"上出了问题;正确地拼接并部署 fullchain,不再踩这个坑。
一、证书链:根、中间、叶子
要理解"链不完整",先要知道这条链长什么样。现实中的 TLS 证书不是"根证书直接签服务器证书",而是一层一层往下签的。
最顶端是根证书(Root CA),它由证书颁发机构(CA)自己签名,预先安装在操作系统和浏览器的信任库里。出于安全考虑,根证书的私钥保护得极其严格,日常签发工作都交给中间证书完成。
中间是中间证书(Intermediate CA),由根证书签发,负责实际签发服务器证书。为什么要有中间层?因为直接把根私钥摆在签发线上风险太大,中间层相当于一道隔离带——一旦出了问题,吊销中间证书即可,不用动根。
最底端是服务器证书(也叫叶子证书、Leaf),由中间证书签发,上面写着你的域名。客户端验证时,会从你的服务器证书一路往上找签发者,直到某个它信任的根证书为止。这条路径就是"证书链"。
关键点来了:根证书不随服务器下发(客户端本地就有),但中间证书必须由服务器主动提供。如果你的服务器只发了叶子证书、没发中间证书,客户端就可能拼不出完整的链——在信任库里能找到对应中间证书的客户端(比如某些浏览器会自动缓存或补全)能连上,找不到的就直接报错。这就是"链不完整"问题的根源。
二、典型症状
链不完整的表现很有迷惑性,常见的几种:
一是"浏览器能开,命令行不能连"。curl、wget、Java 客户端、Python requests 报 unable to get local issuer certificate 或 SSL certificate problem,但 Chrome/Firefox 打开却正常。这是因为现代浏览器有针对性的补全机制。
二是"新旧系统表现不一致"。Windows 7、老版本安卓、部分嵌入式设备打不开,新的系统没事。老设备信任库里没有那个中间证书,链一断就失败。
三是"接口调用方报错"。第三方对接你的 API 时报证书验证失败,而你自己访问一切正常。
四是"移动端 App 内置请求失败"。App 通常不走系统浏览器的那套补全逻辑,对链的完整性和根证书的要求更严格。
出现这些症状,第一件事不是去重新申请证书,而是先诊断链。很多情况下证书本身完全没问题,只是服务器少发了一张中间证书。
三、用 openssl s_client 诊断
诊断证书链最趁手的工具就是 openssl s_client。它模拟一次 TLS 握手,并把服务器返回的证书链原原本本打印出来。
# 基础用法:连接 443 端口并显示证书链
openssl s_client -connect example.com:443 -servername example.com
# -servername 很重要:SNI 场景下不指定可能拿到默认站点的证书
# 加 -showcerts 会打印服务器发来的每一个证书
openssl s_client -connect example.com:443 -servername example.com -showcerts
看输出时关注这几个地方:
# 输出中:
# Certificate chain
# 0 s:/CN=example.com <- 叶子证书
# i:/C=US/O=Let's Encrypt/CN=R3
# 1 s:/C=US/O=Let's Encrypt/CN=R3 <- 中间证书
# i:/C=US/O=ISRG Root X1
# ---
# Server certificate
# 以及末尾的 Verify return code
Certificate chain 段落里列出了几个条目,0 是服务器证书,1、2 是它下发的中间证书。如果这里只有 0 一条,没有中间证书,那基本可以确诊链不完整。再看末尾的 Verify return code:
| Verify return code | 含义 | 说明 |
|---|---|---|
| 0 | 验证成功 | 链完整且可信 |
| 20 | unable to get local issuer certificate | 常见于链不完整或缺中间证书 |
| 21 | unable to verify the first certificate | 本地缺根/中间,链拼不起来 |
| 10 | certificate has expired | 证书已过期 |
| 19 | self-signed certificate in chain | 链中出现自签证书 |
20 和 21 就是链问题最典型的两个返回码。诊断时要特别注意:在服务器本机跑和在客户端跑结果可能不同,因为本机可能装有全套 CA,而客户端没有。最可靠的判断是在一个干净的环境里跑,或者用在线检测服务看它抓到的链。
四、为什么浏览器有时"掩盖"了问题
很多新手困惑:明明浏览器正常,为什么说链不完整?原因是浏览器有一层"容错"。
当服务器没下发中间证书时,部分浏览器会根据证书里的 Authority Information Access(AIA)扩展字段,自动去下载缺失的中间证书,补全后完成验证。这是一个渐进式的补全机制,体验上是"延迟一点但能开"。但这个机制不保证在所有场景都生效——它依赖网络能访问 CA 的 AIA 地址,也可能被缓存策略影响。
而对于不走浏览器逻辑的客户端(curl、SDK、App、物联网设备),没有这层补全,链不完整就直接失败。所以"浏览器能开"从来不是链完整的证据,必须以 openssl s_client 或在线检测的结果为准。
五、修复:把中间证书拼进去
修复的方法很直接——让服务器在下发叶子证书的同时,把中间证书也一起发出去。做法是把证书文件按"叶子证书在前、中间证书在后"的顺序拼成一个 fullchain 文件。
# 拼接顺序很重要:先服务器证书,再中间证书
cat server.crt intermediate.crt > fullchain.crt
# 用 openssl 确认拼接结果里有两段 BEGIN CERTIFICATE
grep -c "BEGIN CERTIFICATE" fullchain.crt
# 期望输出:2(有中间证书时)
# 顺带校验一下链是否正确,-CAfile 指向中间或根证书
openssl verify -untrusted intermediate.crt server.crt
# 输出应类似:server.crt: OK
拼接好之后,在 Web 服务器配置里指向 fullchain.crt。以 Nginx 和 Apache 为例:
# Nginx:ssl_certificate 指向包含完整链的 fullchain,而不是单张叶子证书
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
}
# Apache:SSLCertificateChainFile 独立指定中间证书(老版本)
# 新版本可把中间证书直接拼进 SSLCertificateFile 指向的 fullchain
SSLCertificateFile /etc/apache2/ssl/fullchain.crt
SSLCertificateKeyFile /etc/apache2/ssl/example.com.key
# 老写法(Apache 2.4.8 之前需要单独一行):
# SSLCertificateChainFile /etc/apache2/ssl/intermediate.crt
配置改完先检查语法,再平滑重载,别直接重启:
nginx -t && systemctl reload nginx # Nginx
apachectl configtest && systemctl reload httpd # RHEL 系 Apache
apachectl configtest && systemctl reload apache2 # Debian 系 Apache
风险提示:改证书路径前备份原配置,确认 fullchain.crt 和私钥路径都正确、权限合适(私钥通常 600,属主为运行 Web 服务的用户)。拼错顺序、把叶子证书放后面,同样会导致验证失败。回滚只需把配置指回原来的证书文件并 reload。
六、验证修复是否生效
改完一定要重新诊断,确认 Certificate chain 里出现了中间证书、Verify return code 变成 0。
# 重新握手,确认链里有中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -E "^\s+[0-9] s:"
# 直接看返回码
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep "Verify return code"
# 从客户端侧验证(本机 CA 库)
curl -vI https://example.com 2>&1 | grep -i "SSL certificate"
除了命令行,也可以借助在线的 TLS 检测服务(主流云厂商和第三方都有免费版)查看它抓到的证书链评分,这类服务会从一个"干净"的客户端角度评估,正好能暴露你本机被缓存掩盖的问题。修复后记得在移动端、老旧系统上各测一次,确保覆盖面。
| 常见修复动作 | 目的 | 注意点 |
|---|---|---|
| 拼接 fullchain | 下发中间证书 | 叶子在前、中间在后 |
| 更新中间证书 | 中间证书换签/过期 | CA 会变更中间证书 |
| 配置指向 fullchain | 让服务器发出完整链 | 改完先 nginx -t |
| 客户端侧复测 | 确认跨设备可用 | 别只在本机测 |
常见问题
Q:openssl s_client 返回 20,但网站能打开,需要修吗?
A:需要。返回 20 说明服务器没下发中间证书,只是被你本地浏览器补齐了。换成不补全的客户端(curl、App)就会失败,尽早修复。
Q:根证书要不要一起配到服务器上?
A:通常不需要。根证书客户端本地已有,服务器一般只下发中间证书。个别特殊场景才需要显式提供根,具体以 CA 的文档为准。
Q:中间证书去哪拿?
A:签发证书时 CA 会一并提供,通常在证书下载包里有 ca_bundle.crt 或 intermediate.crt。如果拿不到,可以按 openssl s_client -showcerts 抓取,或从 CA 官网下载。
Q:换了中间证书后需要重新申请服务器证书吗?
A:一般不用。服务器证书没过期、没换域名的话,只需更新中间证书并重新拼接 fullchain 即可,但要用 openssl verify 确认新链正确。
Q:拼了 fullchain 还是报错怎么办?
A:检查拼接顺序(叶子在前)、文件是否完整(grep -c "BEGIN CERTIFICATE")、配置是否 reload 生效,以及服务器证书与私钥是否匹配(openssl x509 -noout -modulus 与私钥 modulus 对比)。
总结
- 证书链是"根证书 → 中间证书 → 服务器证书",根证书客户端本地已有,中间证书必须由服务器主动下发。
- 链不完整的典型症状是"浏览器能开、命令行/App 打不开",因为浏览器有自动补全机制,所以别用浏览器是否正常来判断。
- 诊断靠
openssl s_client -showcerts,看Certificate chain有几段、Verify return code是否为 0。 - 修复靠拼接 fullchain:叶子证书在前、中间证书在后,并在 Nginx/Apache 里指向它,改完
nginx -t后用 reload。 - 修复后换个干净客户端或在线检测服务复测,确认链完整、返回码为 0,再覆盖移动端与老系统验证。
企业QQ咨询




