跳到主要内容
错误排查

SSL证书失败原因怎么排查?7 类根因、真实报错与 openssl 诊断命令(2026 版)

SSL证书失败原因 — SSL证书失败原因怎么排查?7 类根因、真实报错与 openssl 诊断命令(2026 版)
核心结论

一句话结论:SSL证书失败原因多数不是证书没签发,而是链不完整、域名不匹配、时间偏差或协议不兼容;用 `openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null` 看 `Verify return code`,返回 21 就是缺中间证书,返回 10 是过期,返回 62 是域名不匹配。 证书链完整时 `-showcerts` 通常输出 2-3 张证书,`grep -c 'BEGIN CERTIFICATE'` 若为 1,说明只发了叶子证书,需把 intermediate.crt 拼到 fullchain.pem 并 reload。 Nginx 1.26 用 `ssl_certificate fullchain.pem; ssl_protocols TLSv1.2 TLSv1.3;`,Apache 2.4.58 用 `SSLCertificateFile fullchain.pem` 与 `SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1`,改完先 `nginx -t` 或 `apachectl configtest`。 验收时同时跑 `curl -vI https://example.com` 看 `SSL certificate verify ok`、`openssl s_client -tls1_2` 与 `-tls1_3` 成功、`-tls1` 失败,再用 testssl.sh --fast 检查链顺序与 OCSP stapling。

SSL证书失败原因到底分几类?为什么证书没过期也会报错?

把“SSL证书失败原因”先分层,比一上来就重签证书高效得多。浏览器的报错文案其实已经告诉了你该查哪一层——据 Chromium 网络栈文档,ERR_CERT_* 系列全部发生在证书校验阶段,而 ERR_SSL_* 发生在握手阶段,两者对应完全不同的命令。

报错 主要指向 首选诊断命令
NET::ERR_CERT_AUTHORITY_INVALID 证书链不完整 / 根证书不在信任库 openssl s_client -showcerts
NET::ERR_CERT_COMMON_NAME_INVALID SAN 不含当前域名 openssl x509 -ext subjectAltName
NET::ERR_CERT_DATE_INVALID 有效期 / 客户端系统时间 openssl x509 -dates + timedatectl
ERR_SSL_PROTOCOL_ERROR 端口不是 TLS、协议版本或 SNI 不匹配 openssl s_client -tls1_2

为什么证书没过期还是报错?因为“过期”只是四层校验中的一层。最常见的是证书链:服务器应下发“叶子证书 + 中间证书”,根证书留在客户端信任库。据 Let’s Encrypt 文档,中间证书缺失是自建 Nginx/Apache 最常见的配置错误。一条命令即可确认:

# -servername 必带,否则测的是默认站点证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c 'BEGIN CERTIFICATE'
# 期望 >= 2(叶子 + 中间证书);只输出 1 说明链路断了
openssl s_client -connect example.com:443 -servername example.com &1 
  | grep 'Verify return code'
# 典型报错:Verify return code: 21 (unable to verify the first certificate)

补上 intermediate(Nginx 里把 ssl_certificate 指向 fullchain.pem 而非 cert.pem)后,返回码通常变为 0 (ok)。

域名匹配只看 SAN。据 RFC 5280 第 4.2.1.6 节,域名标识以 Subject Alternative Name 扩展为准;现代浏览器(Chrome 58+、Firefox 等)已完全忽略 CN。所以检查方式固定为:

openssl x509 -in leaf.pem -noout -ext subjectAltName
# 应输出 DNS:example.com, DNS:www.example.com

注意通配符边界:*.example.com 只覆盖一级子域,不覆盖裸域 example.com,也不覆盖 a.b.example.com——这两点是申请证书时最常见的漏配。

时间偏差。证书本身没问题、客户端时间却跑到 notBefore 之前,报 certificate is not yet valid;跑到 notAfter 之后报 certificate has expired。分别用 openssl x509 -in leaf.pem -noout -dates 看有效期,用 timedatectl | grep 'System clock synchronized' 确认 NTP 同步状态。

协议与套件。Ubuntu 24.04 默认 OpenSSL 3.0.13 且 SECLEVEL=2,TLS 1.0/1.1 已被禁用(Mozilla Server Side TLS 指南同样建议仅保留 1.2/1.3)。当服务端只开 ssl_protocols TLSv1.2 TLSv1.3;,老客户端会拿到 sslv3 alert handshake failure 或 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。

SNI 与 default_server。同一 IP 承载多证书依赖 SNI,openssl s_client 不加 -servername 会拿到默认证书;Nginx 的 default_server 若配了不匹配域名的证书,直接用 IP 访问就会触发 NET::ERR_CERT_COMMON_NAME_INVALID——这是排查时极易误判为“证书配错了”的假故障。

SSL证书失败怎么排查?从报错到根因的 6 步实操流程

排查 SSL 证书失败,最忌讳“一上来就重签证书”。按下面 6 步走,绝大多数 SSL 证书失败原因在第 2–4 步就能锁定,重签只是最后手段。命令在 OpenSSL 1.1.1 / 3.x、curl 7.54+、Nginx 1.9.2+、Apache 2.4 上通用。

第 1 步:固定现场,再动手改配置。记录客户端(浏览器与版本、操作系统、是浏览器还是 Java/Python 客户端)、发生时间、完整 URL 和报错原文——同一个域名在 Chrome 报错、在 curl 正常,根因往往完全不同。命令行先复现:

# -v 打印握手细节,-I 只看响应头;2>&1 合并 stderr,否则 grep 抓不到错误行
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate|TLSv1'
# 典型输出:
# * SSL certificate problem: unable to get local issuer certificate

只要出现 unable to get local issuer certificate,先按“证书链不完整”处理,而不是怀疑过期。据 Let’s Encrypt 文档,签发产物中 cert.pem 只含叶子证书,必须部署 fullchain.pem(叶子+中间证书),否则部分客户端无法构建信任链。

第 2 步:看服务端实际发出了几条证书。

# -servername 必须带,否则多站点 SNI 会返回默认站点的证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c 'BEGIN CERTIFICATE'
# 返回 1  = 只发了叶子证书,链断
# 返回 2-3 = 叶子 + 中间证书,链基本完整

openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | grep 'Verify return code'
Verify return code OpenSSL 原文 根因
0 ok 链可验证,问题不在服务端证书
21 unable to verify the first certificate 缺中间证书
20 unable to get local issuer certificate 缺中间证书,或客户端信任库不含该根 CA
10 certificate has expired notAfter 已过期
62 hostname mismatch SAN 不含实际访问域名
18 / 19 self-signed certificate (in chain) 用了自签证书,或链中混入自签根

第 3 步:逐项校验证书字段。

openssl x509 -in /etc/nginx/ssl/leaf.pem -noout -subject -issuer -dates -ext subjectAltName
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=Jan  5 00:00:00 2026 GMT
# notAfter=Apr  5 23:59:59 2026 GMT
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com

三个核对点:SAN 必须包含实际访问的域名(自 Chrome 58 起 CN 不再参与匹配,规则见 RFC 6125);notAfter 要晚于当前时间并留出续期余量;issuer 必须与中间证书的 subject 逐字一致,否则链拼不上。

第 4 步:在本地重建一次链。

# Debian/Ubuntu 信任库;RHEL/CentOS 换成 /etc/pki/tls/certs/ca-bundle.crt
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted intermediate.pem leaf.pem
# 通过:leaf.pem: OK
# 失败:error 21 at 0 depth lookup: unable to verify the first certificate
#      → -untrusted 漏了 intermediate.pem,或 fullchain 里中间证书排在叶子前面

只有输出 leaf.pem: OK,才说明这条链在系统信任库下能构建成功;此处的 error 编号与第 2 步表格一一对应。

第 5 步:查服务端配置是否加载了正确的文件。

nginx -T | grep -E 'ssl_certificate|ssl_protocols|server_name'
# ssl_certificate 必须指向 fullchain.pem,指向 cert.pem 就是第 2 步返回 1 的直接原因
apachectl -S && apachectl -t -D DUMP_VHOSTS    # 确认 VirtualHost 的 ServerName 与 SAN 一致

顺手检查是否有多个 server_name 相同、监听同一端口的 server 块——Nginx 按配置顺序取第一个匹配项,改错文件是“改了没生效”的高频原因。

第 6 步:多客户端交叉复测,别只修好一个。

curl --tlsv1.2 --tls-max 1.2 -vI https://example.com   # 模拟旧客户端
curl --tlsv1.3 -vI https://example.com                 # 模拟新客户端
openssl s_client -connect example.com:443 -tls1 </dev/null   # 应握手失败
testssl.sh --fast example.com                          # 交叉验证协议、套件、链、OCSP

TLS 1.0/1.1 已被主流浏览器弃用,-tls1 必须失败;若仍能握手,说明 ssl_protocols 没收敛。最后用 Chrome 无痕窗口复测一次,排除本地缓存与例外规则干扰。只在一个客户端上消除 SSL 证书失败,往往意味着另一个客户端仍在报错。

Nginx/Apache 证书链与 TLS 参数怎么写?可直接复制的配置片段

证书文件放对了位置却仍然报 ERR_CERT_AUTHORITY_INVALID,十有八九是链的顺序或 TLS 参数写错了。下面给出 Nginx 1.26 与 Apache 2.4.58(均以 2025 年底的主流稳定版为基准)可直接复制的配置,并说明每一行为什么这么写。

Nginx:叶子在前、中间在后

# /etc/nginx/conf.d/example.conf  (Nginx 1.26.x 验证通过)
server {
    listen 443 ssl;
    http2 on;                                  # 1.25.1 起替代 listen ... http2
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 叶子证书 + 中间证书,顺序不可颠倒
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;     # 权限 600,属主 root

    ssl_protocols       TLSv1.2 TLSv1.3;       # 1.23.4 起默认值即为此,显式写出便于审计
    ssl_ciphers         HIGH:!aNULL:!MD5;      # TLSv1.3 的套件由 OpenSSL 管理,此行只作用于 1.2
    ssl_prefer_server_ciphers off;             # 现代推荐 off,让客户端选,利于前向兼容

    ssl_session_cache   shared:SSL:10m;        # 1MB ≈ 4000 个会话,10m 约 4 万
    ssl_session_timeout 1d;                    # 默认 5m,调大减少握手开销

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;   # 只放中间证书,不要放叶子
    resolver 223.5.5.5 119.29.29.29 valid=300s;
    resolver_timeout 5s;
}

拼装 fullchain 并自检,确认列出两张证书(叶子和中间):

cat example.com.crt intermediate.crt > fullchain.pem
# 期望输出 Certificate:
#           Subject: CN = example.com
#           Subject: C = US, O = Let's Encrypt, CN = R11
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout

通常不要把根证书拼进去——据 Let’s Encrypt 文档,客户端本就信任根,多带一张只会增大握手包;只有内部 CA 明确要求时才加。ssl_trusted_certificate 指向的是中间链而非叶子,Mozilla SSL Configuration Generator 为 Nginx 生成的片段也是这一指向方式。

Apache 2.4.58:链直接写进 SSLCertificateFile

# /etc/apache2/sites-enabled/example-ssl.conf
SSLCertificateFile      /etc/apache2/ssl/fullchain.pem   # 2.4.8 起可含中间证书
SSLCertificateKeyFile   /etc/apache2/ssl/privkey.pem
# SSLCertificateChainFile 已废弃,无需再写
SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite          HIGH:!aNULL:!MD5
SSLHonorCipherOrder     off
SSLSessionCache         "shmcb:/var/run/apache2/ssl_scache(512000)"
SSLSessionCacheTimeout  86400
项目 Nginx 1.26 Apache 2.4.58
证书链位置 ssl_certificate 指向 fullchain SSLCertificateFile 指向 fullchain
独立链文件 仅 OCSP 用 ssl_trusted_certificate SSLCertificateChainFile 2.4.8 后废弃
协议开关 ssl_protocols SSLProtocol all -SSLv3 ...
语法检查 nginx -t apachectl configtest

改完先检查再重载:nginx -t 需输出 syntax is ok 与 test is successful;apachectl configtest 需输出 Syntax OK。报 nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX() failed 说明文件缺失或格式错误(如把 PKCS#7 当 PEM 用),此时不要 reload,先执行 nginx -T 看展开后的真实路径与 include 顺序。确认无误后平滑重载:

systemctl reload nginx      # 或 systemctl reload apache2,现有连接不断开
curl -vI https://example.com 2>&1 | grep -E "subject:|issuer:|server:"
# 用序列号比对是否换成了新证书
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -serial -dates

若 reload 后浏览器仍显示旧证书,多数是 CDN 或多层反代缓存了旧链——先用 curl -vI 观察响应头 server 与证书序列号是否变化,再逐跳排查,这与 SSL 证书失败原因中”服务端已换、边缘未刷”的典型场景一致。

DV、OV、通配符与多域名证书:哪种方案失败风险更低?

选型本身就是一种失败预防。不同证书方案的证书链长度、覆盖范围和验证方式差异很大,导致 SSL 证书失败原因集中在完全不同的环节。先把四种方案的边界情况列清楚:

方案 常见链长度 覆盖范围 高频失败原因 验收命令
DV 单域名 2 张(叶子证书 + 中间证书) 1 个 FQDN 中间证书漏配、HTTP-01 验证失败 openssl s_client -showcerts
DV 通配符 2 张 *.example.com 一级子域 裸域或二级子域不在 SAN、DNS-01 TXT 未生效 openssl x509 -ext subjectAltName
OV/EV 3–4 张 组织信息 + 域名 旧客户端根证书不受信、证书链顺序错 openssl verify -untrusted
多域名 SAN 2–3 张 常见上限 100 个 SAN 漏加域名、SAN 数量超限 openssl x509 -text | grep DNS
内部 CA / 自签 1–3 张 内网域名 客户端未装根证书、主机名不匹配 keytool -importcert

为什么 DV 反而“更稳”?DV 的失败几乎全部收敛在域名验证环节:HTTP-01 要求 http://<domain>/.well-known/acme-challenge/ 可从公网 80 端口访问(据 Let’s Encrypt 文档,该路径的响应必须返回 key authorization 原文,且不跟随重定向到 HTTPS 以外的主机);DNS-01 则要求 _acme-challenge.example.com 的 TXT 记录在权威 DNS 上生效,TTL 建议 ≤ 60 秒以便快速重试。OV/EV 多了组织主体审核,链更长,2018 年以前的 Android 7.0 以下设备和部分 Java 8 老版本 truststore 更容易因缺少交叉签名根而报 PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。选型第一步应是清点客户端信任库版本,而不是先看价格。

通配符不是万能符。*.example.com 不覆盖裸域 example.com,必须把裸域显式写进 SAN;也不覆盖 a.b.example.com,多级子域需要单独签 *.b.example.com 或改用多域名 SAN。签发后用下面命令逐项核对 SAN 清单(OpenSSL 1.1.1 及以上、3.x 均可用,-ext 需 OpenSSL ≥ 1.1.1):

# 1) 拉取服务器实际下发的完整证书链(-servername 必须给,否则 SNI 站点会拿到默认证书)
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null

# 2) 查看叶子证书的 SAN 列表,确认裸域与所有子域都在其中
openssl x509 -in leaf.crt -noout -ext subjectAltName

# 3) 用中间证书校验链,确认顺序为 叶子 → 中间 → 根
openssl verify -untrusted intermediate.crt -CAfile root.crt leaf.crt
# 期望输出:leaf.crt: OK

多域名 SAN 的边界:单证书常见上限为 100 个 SAN(不同 CA 有差异,Let’s Encrypt 当前限制为 100 个名称)。SAN 越多,握手时下发的 Certificate 消息越大,弱网移动端首包易触发超时。工程上可拆成 2–3 张证书分摊风险,避免单张证书过期或吊销造成全域不可用。

内部 CA 场景必须手动建立信任。自签或私有 CA 签发的证书不会自动被客户端接受,需把根证书导入 truststore,否则服务端日志会出现 unable to find valid certification path。Java 环境的标准做法(JDK 8 至 21 通用,默认密码为 changeit):

# 导入内部根证书到 JVM 默认信任库;生产环境建议用 -cacerts 或复制一份专用 keystore
keytool -importcert -alias internal-root -file root.crt 
  -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit -noprompt

# 验证导入结果
keytool -list -alias internal-root -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit

选型结论可以量化:优先选 DV 或通配符 + 自动化续期(ACME 客户端每 60 天轮换),把人工环节压到最低;确有组织展示需求再上 OV;内网统一走私有 CA 并随镜像预置根证书。这样能把 SSL 证书失败原因从“人忘了配”转移到可监控的自动化流程上。

这些真实报错分别是什么意思?6 类 SSL 报错对照与处理

先给你一条判断主线:报错文本里出现 unable to get local issuer 或 AUTHORITY_INVALID 基本都是信任链问题,出现 COMMON_NAME 或 subject name matches 是身份匹配问题,出现 RECORD_TOO_LONG 或 handshake failure 是协议层问题。下面按 6 类真实报错逐一对照。

1. curl: (60) SSL certificate problem: unable to get local issuer certificate

根因有两个:服务端只发了叶证书没发中间证书,或客户端 CA 信任库过旧。先用一条命令数证书张数,正常链路应为 2 张以上(叶证书 + 中间证书):

# -showcerts 打印服务端发送的完整链,grep 计数;输出 1 即缺中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -c "BEGIN CERTIFICATE"

# 客户端信任库刷新:Debian/Ubuntu
sudo update-ca-certificates
# RHEL / CentOS / Rocky / AlmaLinux
sudo update-ca-trust

服务端修复方式是把 fullchain.pem(叶证书在前、中间证书在后)填进 Nginx 的 ssl_certificate,顺序写反同样会报此错。

2. 浏览器 NET::ERR_CERT_AUTHORITY_INVALID

含义是”签发者不在信任库内”:可能是自签证书、私有 CA 签发但根证书未安装到客户端,或中间证书缺失导致链无法回溯到受信根。用 openssl verify 在本地复现,比反复刷新浏览器快得多:

# 把服务端链导出后逐张校验,输出 error 20 即找不到本地签发者
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -outform PEM > leaf.pem
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem leaf.pem

补链后需强制刷新:Chrome 可重启进程(chrome://restart),因为会话内缓存的证书校验结果不会自动失效。

3. NET::ERR_CERT_COMMON_NAME_INVALID / no alternative certificate subject name matches target host name

2017 年后浏览器只认 SAN(subjectAltName),CN 字段已被完全忽略(RFC 6125 第 6.4.4 节及 CA/Browser Forum 基线要求)。核对命令:

# 直接读 SAN 列表,确认待访问域名在不在里面
openssl x509 -noout -ext subjectAltName -in leaf.pem
# 期望输出形如:DNS:example.com, DNS:*.example.com

注意通配符只匹配一级:*.example.com 覆盖 api.example.com,但不覆盖 a.b.example.com,也不覆盖裸域 example.com。

4. SSL_ERROR_RX_RECORD_TOO_LONG

典型场景是用 https 访问了明文 HTTP 端口,或反向代理把 TLS 流量 proxy_pass 到了后端 80 端口。客户端发出的 ClientHello 被 HTTP 服务器以明文应答,字节被当成一条超长 TLS 记录解析,于是报此错。复现与排查:

# 复现:用 https 打 80 端口
curl -v https://example.com:80/ 2>&1 | head -5
# 反向确认 443 端口是否真的在跑 TLS
curl -v http://example.com:443/ 2>&1 | head -5
# 检查 Nginx 配置:listen 443 必须带 ssl,upstream 若是明文应为 http://
nginx -T 2>/dev/null | grep -nE "listen 443|proxy_pass"

5. sslv3 alert handshake failure / ERR_SSL_VERSION_OR_CIPHER_MISMATCH

协议版本或密码套件无交集。常见于老客户端只支持 TLS 1.0/1.1,而服务端按 Mozilla 中间配置已禁用(Mozilla Server Side TLS 指南将 TLS 1.0/1.1 列为 Old,现代配置最低 TLS 1.2)。逐版本探测:

# 分别用 TLS 1.2 / TLS 1.0 握手,看哪一版被拒
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1   </dev/null
# 列出服务端实际支持的套件
openssl ciphers -v 'DEFAULT' | head -20

是否临时放开 TLS 1.1,应由业务侧真实客户端版本分布决定,而不是一刀切。

6. certificate has expired / Verify return code: 10

# 直接看生效/过期时间
openssl x509 -noout -dates -in leaf.pem
# 输出示例:notBefore=Jan  1 00:00:00 2026 GMT  notAfter=Apr  1 00:00:00 2026 GMT

证书没过期却仍报 10,通常是链上某张中间证书过期。常见 verify 返回码含义如下:

返回码 OpenSSL 常量 含义 处理方向
0 X509_V_OK 校验通过 —
10 X509_V_ERR_CERT_HAS_EXPIRED 证书已过期 续期并 reload
18 X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT 叶证书自签 换受信 CA 证书
20 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY 缺中间证书或信任库旧 补 fullchain / 更新 CA
21 X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE 链不完整 检查证书顺序
62 X509_V_ERR_HOSTNAME_MISMATCH 域名不匹配 核对 SAN

续期环节的自动化检查:acme.sh 用户执行 acme.sh --cron 并确认 --reloadcmd 已配置,否则新证书落盘但服务仍在用旧证书;certbot 用户执行 certbot renew --dry-run,并确认 systemctl list-timers | grep certbot 中 timer 处于启用状态。据 Let’s Encrypt 文档,ACME 客户端应在证书续期成功后主动重载服务,因为服务器进程只在启动时读取证书文件。

怎么确认修复生效?证书链、SNI 与 TLS 版本的 5 项验收

改完配置、nginx -s reload 之后,别只看浏览器地址栏有没有小锁——浏览器会缓存证书状态,部分客户端还会自动去拉取缺失的中间证书,问题很容易被”看起来好了”掩盖。下面 5 项验收建议逐条跑一遍,全部通过再收工。

第 1 项:链数量与校验码,返回 2 还是 3 才对?

# 统计服务端实际下发的证书数量(叶证书 + 中间证书 = 2 或 3)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'

# 单独确认校验结果,必须为 0
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | grep 'Verify return code'
# 期望输出:Verify return code: 0 (ok)

返回 2(叶证书 + 1 张中间证书)是最常见的健康值;返回 3 通常意味着服务端把根证书也一并发了出来,虽然按 RFC 8446 不算违规,但会多占握手字节,Mozilla 的 Server Side TLS 指南建议只下发”叶证书 + 必要的中间证书”。返回 1 则几乎可以断定是漏配中间证书——这也正是 SSL证书失败原因里出现频率最高的一类。注意 -showcerts 只影响客户端打印行为,不改变服务端实际发送内容。

第 2 项:curl 能否同时验证证书与协议版本?

# 一行同时看校验结果和协商出的 TLS 版本
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|TLSv1'
# 期望:* SSL certificate verify ok.
#       * TLSv1.3 (IN), TLS handshake, ...

# 版本边界:两个都必须成功
curl --tlsv1.2 --tls-max 1.2 -sI https://example.com -o /dev/null && echo "TLS1.2 OK"
curl --tlsv1.3 -sI https://example.com -o /dev/null && echo "TLS1.3 OK"

第 3 项:协议边界怎么定?目标是 TLS 1.2 / 1.3 通、TLS 1.0 不通:

openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>&1 | grep Protocol
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null 2>&1 | grep Protocol
openssl s_client -connect example.com:443 -servername example.com -tls1   </dev/null 2>&1 | tail -3
# 预期失败信息(OpenSSL 3.x):error:...:no protocols available

OpenSSL 3.x 在默认安全级别下已禁用 TLS 1.0,出现 no protocols available 属于正常结果,而非配置故障。若业务确有老式 POS 机、嵌入式设备必须走 TLS 1.0,请单独记录例外并配合来源 IP 白名单,别为了个别设备把全局协议下限拉回去。

第 4 项:SNI 是否真的分流到不同证书?

# 同一 IP 上两个域名,subject= 必须不同
for h in a.example.com b.example.com; do
  echo "== $h"
  openssl s_client -connect 203.0.113.10:443 -servername "$h" </dev/null 2>/dev/null | grep 'subject='
done

据 RFC 6066,SNI 由客户端在 ClientHello 中携带;不加 -servername 时返回默认证书是预期行为,但默认证书也应与你对该 IP 直连的预期一致,否则爬虫、老客户端和健康检查会拿到错误证书。

第 5 项:用工具和监控做长期验收

# testssl.sh 快扫,重点看 Chain of Trust / Protocols / OCSP stapling 三节
testssl.sh --fast https://example.com

# 30 天内是否过期:退出码 0 表示未到期
openssl x509 -checkend 2592000 -noout -in leaf.pem; echo "exit=$?"

据 Prometheus blackbox_exporter 文档,probe_ssl_earliest_cert_expiry 返回 Unix 时间戳,告警表达式可写 (probe_ssl_earliest_cert_expiry - time()) / 86400 < 30,比单纯依赖 Let’s Encrypt 的续期邮件更早发现问题。

验收项 通过判据 失败最可能的原因
证书链 证书计数 2–3,Verify return code: 0 (ok) 漏配中间证书、fullchain 顺序颠倒
curl 校验 出现 SSL certificate verify ok 链断裂、系统 CA 库过旧
协议边界 TLS 1.2/1.3 成功,TLS 1.0 失败 ssl_protocols 过宽或过窄
SNI 分流 两域名 subject= 不同 只配了 default_server,未配 server_name
到期与监控 -checkend 退出码 0,告警已生效 自动续期任务失败、路径未更新

证书失败后的应急处理:先回滚还是先补链?

证书一挂,最容易犯的错是「一边救火一边查案」:在还对外报错的生产机上反复重签、反复 reload。正确的顺序永远是先恢复服务,再定位根因。但「回滚」和「补链」不是二选一的口头禅——先花 30 秒判定影响面,再决定走哪条路。

第一步:区分「全站失败」还是「部分客户端失败」。浏览器与 curl 给出的报错语义完全不同,别混着看。全站 ERR_CONNECTION_REFUSED / curl: (7) Failed to connect ... Connection refused 说明 TCP 443 根本没起来,此时回滚证书毫无意义,先查监听与配置语法:

# 443 是否在监听(ss 来自 iproute2,注意需要 root 才能看到进程名)
ss -lntp | grep ':443'
# 期望看到:LISTEN 0 511 0.0.0.0:443 0.0.0.0:* users:(("nginx",pid=1234,fd=...))

# 配置语法 + 证书文件可读性一起校验(nginx 1.9.0+ 支持 -T 打印完整生效配置)
nginx -t
# 成功输出:nginx: configuration file /etc/nginx/nginx.conf test is successful
# 失败常见:nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed

# 看生效配置里 ssl_certificate 到底指向谁(无默认值,必须显式配置)
nginx -T | grep -n 'ssl_certificate'

如果是刚替换完 fullchain.pem 后全站报 ERR_CERT_AUTHORITY_INVALID / curl: (60) SSL certificate problem: unable to get local issuer certificate,或者只有 Android 老版本、部分 Java 客户端失败——按下面这张表分流,别凭感觉:

现象 典型报错 优先动作
所有客户端都连不上 curl: (7) Connection refused、浏览器 ERR_CONNECTION_REFUSED 不回滚证书,查 nginx -t 与 443 监听
换证书后全站握手失败 nginx: [emerg] cannot load certificate、ERR_SSL_PROTOCOL_ERROR 先回滚上一版文件,再排查
浏览器正常、命令行/老设备失败 verify error:num=21:unable to verify the first certificate 先补链,不回滚
仅个别节点异常 同一域名不同 IP 返回不同序列号 单节点回滚,其余不动

回滚优先级:只要确认是「证书文件内容/路径问题」导致全站不可用,立刻恢复上一版并 reload,旧文件不要删——保留原时间戳,它是复盘时唯一的物证。据 Let’s Encrypt 文档,fullchain.pem 应为「叶子证书 + 中间证书」,而 cert.pem 只有叶子,误配是最高频根因。

cd /etc/nginx/ssl
# 备份时就用可追溯的命名,保留时间戳(cp -a / rsync -a)
ls -l --time-style=full-iso fullchain.pem*
cp -a fullchain.pem.20260301T101500 fullchain.pem   # -a 保留 mtime/权限
nginx -t && systemctl reload nginx                  # reload 不断连接,优于 restart
curl -sI https://example.com | head -1              # 期望:HTTP/2 200

补链顺序:服务恢复后再修链。核心是「本地先验,线上后推」——openssl verify 不返回 OK 就绝不 reload,避免把错误链再推一次。

# 1) 确认链里到底几张证书,正常应为 2 张(叶子+中间),只有 1 张即缺链
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout | grep subject

# 2) 拆出叶子与中间证书后本地验链(OpenSSL 3.x 输出 leaf.pem: OK)
openssl x509 -in fullchain.pem -clcerts -nokeys -out leaf.pem
openssl x509 -in fullchain.pem -untrusted fullchain.pem -noout -subject
openssl verify -untrusted intermediate.pem leaf.pem

# 3) nginx 中 ssl_certificate 必须指向 fullchain.pem,而非 cert.pem
# ssl_certificate     /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;

灰度验证:多节点场景先动一台低权重节点,用 --resolve 绕过 DNS 精确打到该 IP,核对序列号一致后再滚动。

# 直连指定节点,校验它返回的证书序列号与日期
curl --resolve example.com:443:10.0.0.12 https://example.com -vI 2>&1 | grep -E 'subject|issuer|expire'
openssl s_client -connect 10.0.0.12:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -serial -dates

记录与复盘:事故窗口内就把证据落盘,事后现场会被下一轮发布覆盖。据 Mozilla SSL Configuration Generator 的建议,把「链数量检查」和「剩余有效期 ≥ 30 天检查」写进发布 checklist,比任何事后总结都有效:

nginx -T > /tmp/nginx-T-$(date +%F-%H%M).txt
openssl s_client -connect example.com:443 -servername example.com -showcerts  /tmp/sclient-$(date +%F-%H%M).txt 2>&1
# 有效期剩余天数快检(<30 天即告警)
openssl x509 -in fullchain.pem -noout -checkend 2592000 || echo "证书将在 30 天内到期"

优先查证书链和域名匹配。跑 `openssl s_client -connect example.com:443 -servername example.com -showcerts

这是客户端找不到签发者链。服务端把 intermediate.crt 拼进 fullchain.pem 并 reload;客户端更新 CA 包,Debian/Ubuntu 用 `sudo update-ca-certificates`,RHEL 系用 `sudo update-ca-trust`。再用 `openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted intermediate.pem leaf.pem` 确认返回 OK。

`*.example.com` 只匹配一级子域,如 `www.example.com`,不匹配 `a.b.example.com`,也不匹配裸域 `example.com`。需要把裸域加入 SAN,二级子域另签 `*.b.example.com` 或使用多域名证书。用 `openssl x509 -noout -ext subjectAltName` 核对实际覆盖范围。

链和 TLS 握手层面差异不大,DV 失败多集中在 HTTP-01/DNS-01 验证,OV 多一层组织审核与链更长。DV 单域名常见价格 0 元(90 天)或 100-300 元/年商业 DV;OV 常见 800-3000 元/年。旧 Java/Android 客户端对 OV 长链更敏感,部署前先用目标客户端复测。

Java 用自己的 truststore,不读系统 CA 包。把中间证书或内部根导入 `cacerts`:`keytool -importcert -alias intermediate -file intermediate.crt -keystore cacerts -storepass changeit`。复测加 `-Djavax.net.debug=ssl:handshake` 看链构建到哪一步失败。

正常,证书 SAN 通常只写域名,不写 IP。需要为 IP 访问单独配默认 server 证书,或在默认 server 返回 444/301。检查 `nginx -T | grep -A5 'default_server'`,确认默认站点没有误用其他域名证书。

常见于用 https 访问了 http 端口,或反向代理把 TLS 请求转到明文后端。用 `curl -v http://example.com:443` 可复现,检查 Nginx `listen 443 ssl` 是否漏写 `ssl`,以及 `proxy_pass` 后端协议是否写成 http。修正后 `nginx -t` 再 reload。


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

内容审核

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