跳到主要内容
错误排查

缺少中间证书报错怎么修?fullchain 顺序与链构建排查指南

缺少中间证书 报错 — 缺少中间证书报错怎么修?fullchain 顺序与链构建排查指南
核心结论

缺少中间证书报错的核心原因是服务器只发送了叶证书,客户端无法按 RFC 5280 构建到受信根的证书路径;把叶证书与中间证书按顺序拼成 fullchain.pem 并正确配置,通常即可消除 curl 60 与 OpenSSL error 20。 用 openssl s_client -connect example.com:443 -servername example.com -showcerts 统计 BEGIN CERTIFICATE 数量,返回 1 说明只发叶证书,返回 2 通常已含中间证书。 Nginx 1.24 必须把 ssl_certificate 指向 fullchain.pem;ssl_trusted_certificate 只服务 OCSP stapling,不能替代客户端链。 Java 报 PKIX path building failed 时先用 openssl verify -untrusted intermediate.crt leaf.crt 判断服务端链,再决定是否 keytool -importcert 导入 cacerts。 Let's Encrypt 的 R3 中间证书于 2025-09-15 到期,续期后应确认 fullchain.pem 已切换到 R10/R11 并重新加载服务。

一、缺少中间证书报错的根本原因是什么?先看链构建而不是只看文件

先给结论:“缺少中间证书 报错”几乎从来不是”服务器上没有中间证书文件”,而是”客户端在构建证书路径时,拿不到能连到本地信任库根证书的那一环”。据 RFC 5280 第 6 节的路径构建算法,验证方以叶证书为起点,沿 Issuer 字段逐级向上找签发者,直到命中本地信任锚;任何一环在候选证书集合中缺失,构建即失败并返回 unable to get local issuer certificate。所以排查顺序永远是:先看链,再看文件。

第一步:看服务器到底发了什么,而不是看磁盘上有什么。Nginx 的 ssl_certificate 只读取你指定的那一个文件(该指令无默认值,必须显式配置),同目录下放着 intermediate.crt 不会自动被发送。用下面的命令抓取实际握手链,注意 -servername 必带,否则 SNI 缺失可能拿到默认站点的证书:

# 抓取服务端实际下发的证书链,只打印 Subject(s) 与 Issuer(i)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -E "^s*[0-9]+ s:|^s*i:"

# 典型"缺中间证书"的输出(只有 0 号证书,链到此为止):
#  0 s:CN = example.com
#    i:C = US, O = Let's Encrypt, CN = R3
# 客户端随后报错(OpenSSL 3.0.x 为 error 20,curl 8.x 为退出码 60):
#  error 20 at 0 depth lookup: unable to get local issuer certificate
#  curl: (60) SSL certificate problem: unable to get local issuer certificate

第二步:确认 fullchain 的顺序是”叶在前、中间在后”。顺序颠倒时,部分客户端会报另一个错误 error 21 unable to verify the first certificate(curl 同样退出码 60,但提示文案不同),很容易被误判成别的问题。根证书通常不放入 fullchain:客户端本地已有,放进去只增加握手字节数。用一条命令即可验证首尾是否相接——每张证书的 Subject 应等于下一张的 Issuer:

# 打印 fullchain.pem 中所有证书的 Subject / Issuer,检查是否链式相接
openssl crl2pkcs7 -nocrl -certfile fullchain.pem 
  | openssl pkcs7 -print_certs -noout

Apache 用户额外注意版本差异:2.4.8 起 SSLCertificateFile 可以直接指向含中间证书的 fullchain 文件,SSLCertificateChainFile 被标记为废弃(deprecated);2.4.8 之前必须单独配置 SSLCertificateChainFile /path/intermediate.crt,否则同样触发上述报错。

为什么浏览器正常、接口却报错?因为客户端对 AIA(Authority Information Access)扩展的处理策略不同,这层差异会长期掩盖问题:

客户端 是否默认按 AIA 抓取中间证书 表现
Chrome / Firefox 是 链不全也能打开,问题被隐藏
curl(OpenSSL 后端) 否 退出码 60,error 20
Java 8u 及之后 否,只信任 cacerts 中的根与显式导入的中间证书 PKIX path building failed
Python requests(certifi) 否 SSLError: unable to get local issuer certificate

还有两类”伪装成缺少中间证书”的情况。一是中间证书自身过期,或交叉签名选错:核对中间证书的 notAfter,并确认叶证书 Issuer 与中间证书 Subject 完全一致;Let’s Encrypt 旧交叉签名链依赖 DST Root CA X3,该根已于 2021-09-30 过期,在旧 Android 上会表现为链验证失败。二是把根证书过期与中间证书缺失混为一谈:ISRG Root X1 有效期至 2035-06-04,而 R3 中间证书于 2025-09-15 到期——续期后仍报错,先看 fullchain 是否还引用旧中间证书,再查客户端信任库版本。

二、完整实操步骤:从确认证书匹配到重载服务

按顺序走完这六步,基本能把”缺少中间证书”的报错修掉。每一步都给出可直接复制的命令和预期输出,出错时对照判断即可。默认环境为 OpenSSL 3.0.x(Ubuntu 22.04 / RHEL 9 自带版本),Nginx 1.24、Apache 2.4.58。

步骤 1:确认叶证书与中间证书真的匹配。最常见的原因是下载了错误链或交叉签名版本(例如 Let’s Encrypt 的 ISRG Root X1 与已交叉签名的 DST Root CA X3 链混用)。据 OpenSSL 文档,x509 -issuer 输出叶证书的签发者 DN,-subject 输出中间证书的主体 DN,两者必须逐字符一致:

# 查看叶证书的 Issuer 字段
openssl x509 -in cert.pem -noout -issuer
# 输出示例:issuer=C = US, O = Let's Encrypt, CN = R10

# 查看中间证书的 Subject 字段
openssl x509 -in intermediate.crt -noout -subject
# 输出示例:subject=C = US, O = Let's Encrypt, CN = R10

# 同时确认中间证书具备 CA 能力(CA:TRUE)且未被当作叶证书使用
openssl x509 -in intermediate.crt -noout -text | grep -A1 "Basic Constraints"
# 期望:CA:TRUE

两行 DN 不一致,说明链文件拿错了,回到签发机构(如 Let’s Encrypt 的 chain.pem)重新下载,不要手工拼凑。

步骤 2:拼接 fullchain,顺序是叶证书在前、中间证书在后。顺序反了会让部分客户端只看到中间证书,等效于”缺少中间证书”报错:

# 叶证书在前,中间证书在后;绝不能把 root.crt 拼进去
cat cert.pem intermediate.crt > fullchain.pem

# 本地验证:用中间证书作为不受信输入去验证叶证书
openssl verify -untrusted intermediate.crt cert.pem
# 期望输出:cert.pem: OK
# 若输出 error 20 at 0 depth lookup: unable to get local issuer certificate
# 说明中间证书仍不正确或链不连续

据 Let’s Encrypt 文档,其下发的 chain.pem 已包含所需中间证书但不含根证书;把根证书塞进 fullchain 会额外增加约 1–2 KB 握手开销,且部分老旧客户端会因多余证书报错。

步骤 3:Nginx 1.24 配置。关键是 ssl_certificate 必须指向 fullchain,而不是单独的叶证书:

server {
    listen 443 ssl;
    server_name example.com;

    # 必须指向 fullchain.pem(叶证书+中间证书),不是 cert.pem
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;
    # 私钥单独指定,权限建议 600、属主 root
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;
}

# 先语法检查,通过后才重载;只 reload 不 test 会把错误配置带上线
nginx -t && systemctl reload nginx

nginx -t 输出 syntax is ok 与 test is successful 两行才算通过;若报 SSL_CTX_use_PrivateKey_file() failed,多为证书与私钥不匹配。

步骤 4:Apache 2.4.58 配置。自 2.4.8 起 SSLCertificateChainFile 已废弃(据 Apache HTTP Server 官方文档),中间证书直接并入 SSLCertificateFile 指向的文件:

SSLEngine on
# 指向 fullchain.pem,Apache 会自动把其中的中间证书一并发送
SSLCertificateFile      /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile   /etc/httpd/ssl/privkey.pem
# SSLCertificateChainFile 在 2.4.8+ 已废弃,保留会打印告警,请注释掉
# SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt

apachectl configtest && apachectl graceful

若仍保留该指令,启动日志会出现 AH02559: The SSLCertificateChainFile directive is deprecated, SSLCertificateFile should be used instead,可据此确认配置版本是否正确。

步骤 5:Java/Tomcat 服务端。JSSE 只认 PKCS12/JKS 里的完整链,把 fullchain 导入即可:

# 用 fullchain.pem 生成 PKCS12,别名 tomcat
openssl pkcs12 -export -inkey privkey.pem -in fullchain.pem 
  -out keystore.p12 -name tomcat -passout pass:changeit

# 查看链长度,Certificate chain length 应 ≥ 2
keytool -list -v -keystore keystore.p12 -storetype PKCS12
# 期望出现:Certificate chain length: 3(叶+R10+ISRG Root X1 交叉或类似)

若显示 Certificate chain length: 1,说明导出时只用了 cert.pem,改用 fullchain 重新生成。

步骤 6:客户端信任库补链。服务端链完整但 Java 调用方仍报 sun.security.validator.ValidatorException: PKIX path building failed,通常是客户端信任库缺少中间证书(多见于 JDK 8u 早期版本或私有 CA 场景):

# 把中间证书导入 JDK 默认信任库(需写权限,默认口令 changeit)
keytool -importcert -alias intermediate -file intermediate.crt 
  -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit -noprompt

# 确认导入成功
keytool -list -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit | grep intermediate

导入后必须重启调用方进程(JVM 在启动时加载 cacerts)。对内部 API 场景,更稳妥的做法是把中间证书纳入配置管理(如独立的 truststore 随应用发布),避免每台机器手工改 cacerts。

三、配置与命令示例:OpenSSL 3.0、Nginx 1.24、Apache 2.4.58 怎么写

怎么用 OpenSSL 3.0.13 确认到底是“缺中间证书”还是“链顺序错”?

先用 openssl verify 把根、中间、叶三层分开摆,报错码会直接告诉你是哪一环出的问题(行为遵循 OpenSSL 官方 verify(1) 文档)。

# root.crt = 自签根;intermediate.crt = 中间 CA;leaf.crt = 服务器叶证书
openssl verify -CAfile root.crt -untrusted intermediate.crt leaf.crt
# 期望输出:leaf.crt: OK

# 只信系统根库(Debian/Ubuntu 路径),复现真实客户端的验证过程
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted intermediate.crt leaf.crt

error 20 at 0 depth lookup: unable to get local issuer certificate 就是典型的缺少中间证书报错:去掉 -untrusted 参数即可稳定复现。error 21 ... unable to verify the first certificate 则说明首证书本身对不上(叶证书配错,或 fullchain 里叶证书不在第一行)。

Nginx 1.24.0 怎么写才不影响客户端链?

server {
    listen 443 ssl;
    server_name example.com;

    # 客户端收到的链完全由这一行决定:叶证书在前,中间证书在后,根证书不放
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;

    # chain.pem 只喂给 OCSP stapling 做校验,不参与客户端握手
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
    ssl_stapling on;                # 默认 off
    ssl_stapling_verify on;         # 默认 off
    resolver 223.5.5.5 valid=300s;
}
# 生成:cat leaf.crt intermediate.crt > fullchain.pem
# 生效:nginx -t && nginx -s reload

据 Mozilla SSL Configuration Generator,ssl_trusted_certificate 与 ssl_certificate 职责不同,混用是 stapling 失败的高频原因。

Apache 2.4.58 与 HAProxy 2.6 的区别在哪?

# Apache 2.4.8 起:叶+中间写进同一个文件,不再需要 SSLCertificateChainFile
SSLEngine on
SSLCertificateFile    /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/privkey.pem
# 若仍写 SSLCertificateChainFile,error_log 会提示:
# AH02559: The SSLCertificateChainFile directive is deprecated ...

# HAProxy 2.6:私钥必须内联在 crt 文件里,顺序为 私钥→叶→中间
cat privkey.pem leaf.crt intermediate.crt > /etc/haproxy/certs/example.com.pem
# bind :443 ssl crt /etc/haproxy/certs/example.com.pem

Tomcat 10 / Java 17 和 curl 8.5 怎么收尾验证?

openssl pkcs12 -export -inkey privkey.pem -in fullchain.pem 
  -certfile intermediate.crt -out keystore.p12 -name tomcat
keytool -list -v -keystore keystore.p12 | grep 'Certificate chain length'   # 应为 3

curl -vI https://example.com --cacert root.crt 2>&1 
  | grep -E 'SSL certificate verify|subject|issuer'   # 成功显示 SSL certificate verify ok.,退出码 0
组件(版本) 关键指令 文件内容与顺序 常见坑
Nginx 1.24.0 ssl_certificate 叶→中间(fullchain) 只放叶证书,触发缺少中间证书报错
Apache 2.4.58 SSLCertificateFile 叶→中间 仍配 SSLCertificateChainFile 产生废弃告警
HAProxy 2.6 crt 私钥→叶→中间 crt 缺私钥直接启动失败
Tomcat 10 / Java 17 keystoreFile + PKCS12 PKCS12 内含完整链 -certfile 漏传中间证书

链构建规则见 RFC 5280 第 6 节:验证方从叶证书出发逐级向上找签发者,任何一级缺失都会以 error 20 终止,这正是“缺少中间证书 报错”在各类服务端日志里表现一致的根本原因。

四、方案选型对比:fullchain、独立链文件与信任库导入怎么选

选哪种方式,取决于谁来验证这条链:是浏览器(Nginx/Apache 对外)、是 JVM(Tomcat 服务端)、还是你自己的客户端代码(Java/Python 调用方)。表里四类场景的配置位置完全不同,配错位置就等于没配——这正是很多“缺少中间证书 报错”反复出现的原因。

方案 适用组件 关键参数 版本 / 限制 推荐场景
单文件 fullchain Nginx 1.24、Apache 2.4.58、HAProxy 2.6 Nginx/HAProxy:ssl_certificate fullchain.pem;Apache:SSLCertificateFile fullchain.pem 顺序必须是叶证书 → 中间证书;根证书不要放;Apache 自 2.4.8 起支持在同一文件内堆叠多段 PEM 通用 HTTPS 站点,首选
独立链文件 Apache 2.4.8 之前的版本、部分老旧负载均衡 SSLCertificateChainFile chain.pem 2.4.8 起官方标记为废弃(obsolete),保留可能产生启动告警 仅用于旧环境兼容
PKCS#12 导入 Tomcat 9/10、Spring Boot 内嵌 Tomcat、Java 服务端 openssl pkcs12 -export -certfile chain.pem;server.ssl.key-store=server.p12 JDK 9+ 默认 keystore 类型为 PKCS12;导出后链长度应 ≥2 Java 服务端对外提供 TLS
客户端信任库导入 Java 调用方、Python requests(verify=/path/ca.pem) keytool -importcert -file intermediate.crt -keystore cacerts 需分发到所有客户端;cacerts 默认口令 changeit,改过要显式传 -storepass 内部 API 互信、自签/私有 CA
CDN / 云负载均衡上传 阿里云 SLB、腾讯云 CLB、AWS ACM 上传 fullchain,或由平台自动补链 部分平台只接受叶证书并自动拼接中间证书,上传顺序错误会被拒绝或静默丢弃 不想自管链的站点

Java 服务端最容易踩的坑是只导入了叶证书。正确做法是把私钥、叶证书、中间证书一起打包,并回读验证链长度:

# 1) 打包 PKCS#12:-certfile 必须是中间证书(不含根),否则链长度为 1
openssl pkcs12 -export 
  -in  cert.pem           # 叶证书(服务器证书)
  -inkey privkey.pem      # 私钥
  -certfile chain.pem     # 中间证书,可多段 PEM
  -name tomcat            # 别名,Tomcat 中无需引用
  -out server.p12 
  -passout pass:changeit   # 默认建议值,与 JDK cacerts 习惯一致

# 2) 回读校验:Certificate chain length 必须 ≥ 2
keytool -list -v -keystore server.p12 -storepass changeit | grep -i "chain length"
# 输出示例:Certificate chain length: 2

如果 chain length 显示 1,说明 -certfile 漏了或指向了根证书;这正是 Tomcat 侧“缺少中间证书 报错”的典型成因。客户端信任库同理,但方向相反——把中间证书导入 cacerts 后,任何未同步该文件的调用方仍会抛 PKIX path building failed,所以内部互信优先考虑用私有 CA 签发而非逐台导入。

成本维度上,据 Let’s Encrypt 官方文档,其证书完全免费且有效期 90 天(可通过 ACME 客户端自动续期),适合 fullchain 自动化流程;商业 DV 证书常见 100–1000 元/年,OV 证书常见 1000–5000 元/年,差价主要买的是组织验证与保险赔付,而非链构建能力——链的完整性在任何价位上都由你自己的配置决定。

五、常见错误与排查:这些真实报错分别代表什么

同一张证书在不同客户端上会报出完全不同的错误码,但根因往往只落在三类:链没发全、链顺序错、根不受信(或中间证书已过期)。先按下表定位,再进入对应命令复测。

真实报错 典型客户端 / 版本 最可能根因 一行验证
curl: (60) SSL certificate problem: unable to get local issuer certificate curl 8.x 服务端只下发叶证书,缺少中间证书 openssl s_client … | grep -c ‘BEGIN CERTIFICATE’
error 20 at 0 depth lookup: unable to get local issuer certificate OpenSSL 3.0 缺中间证书 openssl verify -untrusted intermediate.crt leaf.crt
error 21 at 0 depth lookup: unable to verify the first certificate OpenSSL 3.0 首证书不是叶证书 / 拼接顺序反了 同上,检查 PEM 首块 subject
NET::ERR_CERT_AUTHORITY_INVALID Chrome 根不受信、中间证书过期(浏览器已走 AIA 补链) SSL Labs 看 Chain issues
PKIX path building failed: unable to find valid certification path Java 8/11/17 服务端链不全,或 cacerts 中无该中间证书 keytool -list -v -keystore $JAVA_HOME/lib/security/cacerts
certificate verify failed: unable to get local issuer certificate Python requests + certifi 2024.x certifi 只含根证书,不抓中间证书 verify=ca_bundle 复测

curl 报 (60) 时,怎么确认是”只发了叶证书”?
curl 8.x 默认使用系统 CA 包(可用 --cacert 覆盖),它不会自动去 AIA 抓取中间证书,所以链不全立刻失败。用下面命令数服务端实际下发的证书块:

# 统计服务端下发的证书数量:1=仅叶证书,2=叶+中间,3=完整链
openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'
# 期望输出 2 或 3;输出 1 即证实"缺少中间证书"导致的报错

# 按 RFC 8555/5280 顺序拼接:叶证书必须在前,中间证书在后
cat leaf.crt intermediate.crt > fullchain.pem

# Nginx 1.11+ 示例:ssl_certificate 必须指向 fullchain,而非单张叶证书
# ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 关键行
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
nginx -t && nginx -s reload

# 复测
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate|issuer'

OpenSSL 的 error 20 和 error 21 有什么区别?
据 OpenSSL 3.0 verify(1) 手册,两者都发生在链构建阶段,但含义不同:error 20(X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY)说明验证器找不到签发者,绝大多数是缺中间证书;error 21(X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE)说明第一张证书本身就验不过,常见于 fullchain 顺序写反、把私钥或注释混进 PEM、或文件被截断。用 -untrusted 显式喂入中间证书即可隔离变量:

# 适用 OpenSSL 1.1.1 / 3.x;-untrusted 提供中间证书,避免依赖系统 CA 目录
openssl verify -untrusted intermediate.crt leaf.crt
# 期望:leaf.crt: OK
# 若仍报 error 20 → intermediate.crt 不是正确签发者或本身已过期
# 若报 error 21 → 检查 leaf.crt 是否真是链首(openssl x509 -in leaf.crt -noout -subject -issuer)

Chrome 报 NET::ERR_CERT_AUTHORITY_INVALID,为什么服务端缺链反而看不出来?
Chrome 实现了 AIA(Authority Information Access)补链,会自动下载中间证书,所以”缺中间证书”在浏览器里经常被掩盖;真正触发该错误的多是根证书不在信任库或中间证书已过期。用 Qualys SSL Labs 的 Chain issues 字段判断:显示 Incomplete 即链不全,显示 Contains anchor 则是把根证书也塞进了 fullchain(多数场景应去掉,减小握手体积)。

Java 的 PKIX path building failed 怎么查?
先确认服务端链 ≥2 张(见上面的 grep -c)。若服务端完整,则问题在客户端信任库——JDK 的 cacerts 默认口令为 changeit:

# 查看 cacerts 中是否已导入该中间证书(按 issuer 过滤)
keytool -list -v -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit | grep -i issuer
# 未命中则导入(-alias 自定义,避免覆盖同名条目)
keytool -importcert -alias my-intermediate -file intermediate.crt 
  -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit

Python requests 为什么在 certifi 上翻车?
certifi 2024.x 的 CA 包只包含根证书,不负责抓取中间证书,因此服务端一旦缺链就抛 SSLError: certificate verify failed: unable to get local issuer certificate。临时绕过可指向含中间证书的 PEM,长期仍应修服务端 fullchain:

# 临时方案:ca_bundle = 系统根包 + 中间证书拼接
cat "$(python -c 'import certifi;print(certifi.where())')" intermediate.crt > ca_bundle.pem
# requests.get(url, verify="ca_bundle.pem")

旧设备(Android 4.x / 7 以下、老 curl)为什么补了中间证书还报错?
这是根证书过期而非链不全。据 Let’s Encrypt 公告,其交叉签名链依赖的 DST Root CA X3 已于 2021-09-30 过期;只补中间证书无法解决,需要评估签发使用 ISRG Root X1 交叉签名的证书,或升级客户端 TLS 栈。此类场景建议同时核对客户端支持的 TLS 版本与签名算法,而非继续在 fullchain 上打补丁。

六、效果验证方法:如何确认链已完整生效

改完 fullchain 顺序后,最危险的状态是”看起来好了”——Chrome 能打开、curl 不报错,但 Android 7 或 Java 客户端仍然抛 PKIX path building failed。原因是浏览器会用证书里的 AIA 地址自行抓取中间证书兜底,多数非浏览器客户端不会。因此验证的落点必须是”服务端在握手中实际下发了什么”。

第一招:数证书张数,再看验证码

# 数服务端实际发送的证书张数(Nginx / Apache / 云负载均衡通用)
# </dev/null 防止 s_client 等待标准输入而挂起
openssl s_client -connect example.com:443 -servername example.com 
  -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 期望输出 >=2(叶证书 + 至少一张中间证书);输出 1 说明只发了叶证书

# 看握手末尾的验证结论
openssl s_client -connect example.com:443 -servername example.com 
  </dev/null 2>/dev/null | grep 'Verify return code'
# Verify return code: 0 (ok)      ← 链验证通过
# Verify return code: 20 (unable to get local issuer certificate)  ← 典型缺中间证书

注意 -servername 不能省:SNI 缺失时服务端会返回默认站点证书,你验的可能根本不是目标域名。

第二招:用 openssl verify 把”链不全”和”根不受信”分开

# 带着中间证书一起验:这是"链本身是否正确"的判定
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted intermediate.crt leaf.crt
# leaf.crt: OK

# 去掉 -untrusted 再跑一次
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt leaf.crt
# 若此处失败而上面成功 → 中间证书没随服务端链发送,不是根证书不受信

这两条命令是区分故障域的关键:-untrusted 通过、去掉后失败,说明文件内容没问题,问题在 Web 服务器配置的证书文件或拼接顺序;两次都失败才需要怀疑 CA 包过期或自签根未导入。

第三招:curl 与结构化输出

curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|subject:|issuer:'
# *  SSL certificate verify ok.

# 只看机器可读结论(curl 7.52+ 支持 %{ssl_verify_result})
curl -sS -o /dev/null -w 'http=%{http_code} verify=%{ssl_verify_result}n' https://example.com
# http=200 verify=0 ;校验失败时 curl 退出码为 60(SSL certificate problem)

据 curl 官方文档,退出码 60 专指证书链校验失败,可与 7(连接失败)、35(握手失败)区分开。curl --trace-time 还能看 TLS 1.3 握手时间戳,链完整只增加首字节里几毫秒的证书传输量,通常不会多出额外 RTT。

验证手段 关键参数 通过判据 失败含义
openssl s_client -showcerts grep -c ‘BEGIN CERTIFICATE’ ≥2 等于 1:只发叶证书
openssl s_client grep ‘Verify return code’ 0 (ok) 20 / 21 / 2:链不全或根不受信
openssl verify -untrusted intermediate.crt leaf.crt: OK 去掉 -untrusted 才失败 → 中间证书未下发
curl 8.x %{ssl_verify_result} 0,退出码 0 退出码 60:证书校验失败
SSL Labs Chain issues None Incomplete:缺中间证书
Chrome 124 DevTools Security → 查看证书路径 叶→中间→根 缺中间层但仍可访问:AIA 兜底成功

Qualys SSL Labs 的报告中 Chain issues 一栏写 None 才算链完整,写 Incomplete 即服务端未下发中间证书;同时应确认 Certificate #2 的 Subject 是中间 CA 而非根证书(发根本身是多发,不是缺失)。Chrome 开发者工具里点击证书能看到完整路径,但”页面能打开”绝不等于服务端链完整——这正是缺少中间证书报错只在旧 Android、Java、Python requests(未启用 AIA)上暴露的原因。

顺带确认 OCSP stapling 是否真的生效

openssl s_client -connect example.com:443 -servername example.com -status 
  </dev/null 2>/dev/null | grep -A2 'OCSP Response Status'
# OCSP Response Status: successful (0x0)   ← stapling 生效
# 无输出或 "no response sent" 表示未 stapling

# Nginx 侧必需三行,缺一不可
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;  # 必须含中间证书,否则 stapling 静默失效

链完整只是”信任可建立”的底线;要拿到 SSL Labs 的 A 及以上,还需 TLS 1.2/1.3 双协议、HSTS 响应头、安全的套件顺序一并达标,这些属于下一层排查。

七、预防与自动化:续期后如何避免再次缺少中间证书

续期是“缺少中间证书 报错”最常见的复发点:证书文件换了,但重载没跟上;或者部署脚本只复制了 cert.pem。据 Let’s Encrypt 文档,Certbot 2.11 起 /etc/letsencrypt/live/example.com/fullchain.pem 默认就是“叶证书在前、中间证书在后”的拼接结果,Nginx 的 ssl_certificate 应直接指向它,而不是 cert.pem。

Certbot 续期后怎么保证自动生效、且不会把单证书推上线?把逻辑放进 renewal-hooks/deploy/,Certbot 每次续期成功都会执行该目录下所有可执行脚本:

#!/usr/bin/env bash
# 保存为 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh,并 chmod +x
set -euo pipefail
CHAIN=/etc/letsencrypt/live/example.com/fullchain.pem
# 先校验:fullchain 必须含叶证书 + 至少 1 张中间证书
[ "$(grep -c 'BEGIN CERTIFICATE' "$CHAIN")" -ge 2 ] 
  || { echo "fullchain 仅含单张证书,拒绝重载" >&2; exit 1; }
nginx -t && systemctl reload nginx   # 配置有误则中止,旧进程继续用旧证书

用 acme.sh 3.0.7 安装证书时容易漏哪一步?漏 --fullchain-file。只写 --cert-file 会把叶证书单独落到 Nginx 目录,链就此断裂,客户端立刻报缺少中间证书错误:

acme.sh --install-cert -d example.com 
  --key-file       /etc/nginx/ssl/privkey.pem 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      'nginx -t && systemctl reload nginx'   # 续期后自动重载
部署方式 链的产物 重载触发 典型风险
Certbot 2.11 + deploy-hook 自动生成 fullchain.pem 钩子脚本内执行 钩子未加可执行权限则不触发
acme.sh 3.0.7 --install-cert 由 --fullchain-file 决定 --reloadcmd 误用 --cert-file 导致只拷叶证书
手工复制 cert.pem 无中间证书 无 链不完整,且到期无人知

怎么在出故障前就发现?每日巡检脚本,用 openssl s_client 统计服务端实际下发的证书张数(必须带 -servername 触发 SNI,否则可能连到默认站点):

#!/usr/bin/env bash
# cron: 0 6 * * * /usr/local/bin/check-chain.sh
H=example.com
cnt=$(openssl s_client -connect "$H:443" -servername "$H" -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE')
exp=$(openssl s_client -connect "$H:443" -servername "$H" </dev/null 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
left=$(( ($(date -d "$exp" +%s) - $(date +%s)) / 86400 ))
[ "$cnt" -lt 2 ] && { echo "CRIT: 链上仅 $cnt 张证书"; exit 2; }
[ "$left" -lt 30 ] && { echo "WARN: $left 天后到期"; exit 1; }

部署流水线里怎么阻断?在 CI 中跑 OpenSSL 链验证,失败即拒绝发布,防止 fullchain 被误覆盖成单证书:

openssl verify -untrusted chain.pem leaf.pem
# 成功输出:leaf.pem: OK
# 链断裂时典型报错:error 20 at 0 depth lookup: unable to get local issuer certificate
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null

续期后还要盯什么?中间证书本身也会轮换。据 Let’s Encrypt “Chains of Trust” 文档,旧中间证书 R3 于 2025-09-15 到期,R10/R11 已逐步替代;续期后应用 openssl x509 -in fullchain.pem -noout -issuer 比对 Issuer 是否变化,并同步更新 Java cacerts 等固定信任库的环境。把链检查与 OCSP stapling、HSTS、TLS 1.3(RFC 8446)、ACME 续期、CT 日志(RFC 6962)一并纳入站点巡检,并在内部文档记录根证书/中间证书来源、到期日与负责人,交接时不必再靠猜。

不一定。Nginx 只发送 ssl_certificate 指定文件中的证书,必须把叶证书与中间证书拼成 fullchain.pem 并指向它;Apache 2.4.8 之后合并到 SSLCertificateFile。根证书通常不放入,放错顺序也会报 error 21。

浏览器常通过 AIA 扩展自动抓取中间证书并缓存,curl、Java、Python requests 默认不抓取。服务端应主动发送完整链;Java 还需确认 cacerts 含对应根证书或中间证书。用 openssl s_client -showcerts 统计证书数量即可判断。

一般不放。根证书已在客户端信任库中,放入会增加握手体积;据 Let's Encrypt 文档,fullchain 指叶证书加中间证书。若某些老客户端要求,可单独提供链文件,不要默认塞入根证书。

不能。ssl_trusted_certificate 仅用于 OCSP stapling 验证,客户端收到的证书链由 ssl_certificate 决定。必须把 fullchain.pem 配到 ssl_certificate,ssl_trusted_certificate 可指向 chain.pem。两者混淆是常见配置错误。

CDN/云负载均衡通常自动补链,省去拼接和续期重载,但引入平台依赖、上传格式限制和流量费用;自建 fullchain 成本低、可控,但需要自己监控链完整性和续期。Let's Encrypt 证书费 0 元,商业 DV 常见 100-1000 元/年,OV 常见 1000-5000 元/年。

先执行 openssl s_client -connect host:443 -servername host -showcerts 确认服务端链≥2;若服务端完整,导入中间证书到 cacerts:keytool -importcert -alias intermediate -file intermediate.crt -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit。重启应用后用 keytool -list -v 确认链。

R3 中间证书于 2025-09-15 到期,续期后 fullchain.pem 可能切换到 R10/R11。先检查 fullchain 中 Issuer 是否变化,再重载 Nginx/Apache;旧 Android 或固定信任库环境需同步更新 CA 包。不要只替换 cert.pem。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。