跳到主要内容
基础知识

SSL 证书不受信任怎么排查?根证书信任库、SNI 与客户端兼容实战

ssl证书不受信任 — SSL 证书不受信任怎么排查?根证书信任库、SNI 与客户端兼容实战
核心结论

1) SSL 证书不受信任通常不是“证书没买对”,而是客户端找不到可信根证书、SNI/主机名不匹配或系统时间错误;用 openssl s_client -connect example.com:443 -servername example.com -verify_return_error 可在 1 分钟内复现验证结果。 2) 服务端应部署“站点证书+中间证书”的 fullchain,根证书不要下发;Nginx 1.20+ 用 ssl_certificate /etc/nginx/ssl/fullchain.pem; ssl_certificate_key ...; ssl_trusted_certificate 用于 OCSP stapling。 3) Java 8u301/11+ 默认 cacerts 不包含私有 CA 或部分新根,需 keytool -importcert -cacerts -alias corp-root -file corp-root.crt 导入并用 keytool -list -cacerts 验证。 4) 老 Android 7.0 以下、Windows 7 未更新根证书、企业 TLS 解密代理都会导致浏览器报 NET::ERR_CERT_AUTHORITY_INVALID;需要单独维护信任库或放行代理根证书。 5) 验收以 openssl verify 返回 0、curl --cacert 退出码 0、Java 请求无 PKIX 异常、SSL Labs 评级 A 及以上为准。

为什么同一张 SSL 证书在浏览器正常,curl 或 Java 却提示不受信任?

先给结论:浏览器显示正常、curl 或 Java 却报错,说明这张证书本身大概率没有问题,出问题的是该客户端的证书路径验证。按 RFC 5280 第 6 节的路径验证算法,客户端要从站点证书开始,逐级向上回溯到本地信任库里的根证书,同时校验有效期、主机名、密钥用途(EKU)、基本约束和吊销状态;任何一环断开,最终都会在界面上显示成一句笼统的“SSL 证书不受信任”。所以不要急着重新签发证书,先定位断在哪一环。

最大的差异来源是根证书信任库。同一张站点证书,在 Windows Chrome 里正常,在 Java 8u301 里却抛出 sun.security.validator.ValidatorException: PKIX path building failed ... unable to find valid certification path to requested target,通常只是该 JVM 的 cacerts 里没有对应根证书,与证书有效期、加密套件无关。

客户端 信任库来源 位置 / 更新方式 典型报错
Windows Chrome / Edge Microsoft Trusted Root Program 随系统更新,certmgr.msc 可查看 NET::ERR_CERT_AUTHORITY_INVALID
macOS / iOS Safari Apple Root CA “钥匙串访问”;iOS 用户自装根证书还需手动开启“信任” 此证书的签发者无效
Firefox Mozilla NSS(独立 cert9.db) 默认不读系统根,需开启 security.enterprise_roots.enabled SEC_ERROR_UNKNOWN_ISSUER
Java 8 / 11 / 17 cacerts $JAVA_HOME/lib/security/cacerts(Java 8 为 jre/lib/security/cacerts),默认口令 changeit PKIX path building failed
Android 7+ 系统 CA + 用户凭据 App 默认不信任用户 CA,需 networkSecurityConfig 显式放行 Trust anchor for certification path not found
Linux curl / wget ca-certificates 包 Debian 系 /etc/ssl/certs/ca-certificates.crt;RHEL 系 /etc/pki/tls/certs/ca-bundle.crt (60) unable to get local issuer certificate

第二个高频误判是中间证书缺失。Chrome 会顺着证书里的 AIA 地址自动补链,而 curl 7.81、Java 11、Android 7.1 一般不会补。下面这条命令用来数返回的证书张数,公网站点正常应为 2–3 张(站点证书 + 中间证书),根证书不应下发:

# 带 SNI 抓取完整证书链,并统计张数(正常 2-3 张)
openssl s_client -connect www.example.com:443 
  -servername www.example.com -showcerts /dev/null 
  | grep -c "BEGIN CERTIFICATE"

# 直接看验证结果:末行应为 "Verify return code: 0 (ok)"
# 非 0 即链不完整或信任库缺失(OpenSSL 1.1.1 / 3.x 行为一致)
openssl s_client -connect www.example.com:443 
  -servername www.example.com -verify_return_error </dev/null

第三个坑是 SNI。同一 IP 绑定多域名时,不带 -servername 的 openssl s_client 会拿到默认站点的证书,于是把“测错证书”误判成证书不受信任。TLS 1.3 的 ClientHello 依然携带 SNI 扩展,测试时必须显式写明域名。

企业代理和杀毒软件做 TLS 解密时会插入自签根证书,curl 的典型报错是 curl: (60) SSL certificate problem: self signed certificate in certificate chain。浏览器因系统信任库已装代理根而正常,命令行因 CA bundle 不含代理根而失败,需要按客户端分别导入:

# Java:确认 cacerts 中是否存在目标根证书(默认口令 changeit)
keytool -list -cacerts -storepass changeit | grep -i "your-ca"
# Java 8 请改用:-keystore "$JAVA_HOME/jre/lib/security/cacerts"

# 导入企业代理根证书,导入后需重启 JVM 才生效
keytool -importcert -noprompt -alias corp-proxy-root 
  -file corp-root.crt -cacerts -storepass changeit

# curl:用指定 CA bundle 复测,排除系统 bundle 缺项
curl -vI https://www.example.com --cacert /etc/ssl/certs/ca-certificates.crt

最后不要忽略系统时间和吊销检查。时钟偏差超过 5 分钟会报 certificate is not yet valid 或 certificate has expired;OCSP/CRL 拉取失败在部分客户端表现为 revoked 或 unable to get certificate CRL。先对齐时间,再排查链和信任库:

# 用 UTC 时间对比证书有效期
date -u
openssl s_client -connect www.example.com:443 -servername www.example.com /dev/null 
  | openssl x509 -noout -dates -subject -issuer

# 查看 OCSP 装订状态(无响应不等于证书无效,仅说明未装订)
openssl s_client -connect www.example.com:443 -servername www.example.com -status </dev/null 
  | grep -A2 "OCSP Response"

排查顺序建议固定为:先用 -servername 确认测到的是目标证书 → 数链上证书张数 → 用 -verify_return_error 看返回码 → 比对客户端信任库 → 最后核对时间与吊销。据 Mozilla 的 CA 证书计划文档,Firefox 的信任决策独立于操作系统,这正是“系统里装了根证书、Firefox 仍报未知颁发者”的常见原因。

SSL 证书不受信任的完整排查步骤:从报错复现到客户端信任库

第 1 步:先复现原始报错,不要急着换证书。“不受信任”其实是几类完全不同的故障共用的提示语。Chrome 96 及以后,点地址栏锁形图标 →「连接不安全」→「高级」,就能看到具体错误码:NET::ERR_CERT_AUTHORITY_INVALID 表示证书链或根证书不在本地信任库;NET::ERR_CERT_COMMON_NAME_INVALID 表示 SAN 里没有当前访问的主机名;NET::ERR_CERT_DATE_INVALID 表示当前时间落在 Not Before 与 Not After 之外(常见于服务器时间不同步或证书已过期)。接着用命令行把同一件事复现一次:

# curl 7.81+:-v 会打印 TLS 握手和证书校验细节,-I 只取响应头
curl -vI https://www.example.com 2>&1 | grep -Ei 'SSL|certificate|subject|issuer|expire'

# OpenSSL 3.0:-servername 触发 SNI,-verify_return_error 让校验失败立即报错而不是静默继续
openssl s_client -connect www.example.com:443 -servername www.example.com -verify_return_error </dev/null

漏掉 -servername 是最常见的自我误导:在 Nginx 这类按 SNI 分流的服务器上,不发送 SNI 就会回落到默认 server 块,你看到的可能是另一张证书。据 OpenSSL 文档,-servername 正是用来设置 TLS SNI 扩展的。

第 2 步:查看服务端实际下发了哪些证书。很多“不受信任”是因为服务器只发了叶证书、没发中间证书,桌面浏览器靠缓存补上了,移动端或 Java 客户端却直接失败。

# -showcerts 输出整条链;管道给 x509 逐个打印 subject / issuer / 有效期
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 判断链是否可验证:输出末尾必须出现 Verify return code: 0 (ok)
openssl s_client -connect www.example.com:443 -servername www.example.com -verify_return_error </dev/null 2>&1 | tail -5

常见的非零返回值有:unable to get local issuer certificate(缺少中间证书)、self-signed certificate in certificate chain(链里混入了自签根,却没有配套的信任分发)、certificate has expired。只要这里的返回值不是 0,问题就在服务端下发的证书链,不在客户端。

第 3 步:单独验证主机名与 SAN。证书链完全正确,主机名却仍然不匹配的情况非常普遍:

# OpenSSL 1.1.0+ 支持 -checkhost / -checkip
openssl x509 -in leaf.pem -noout -checkhost www.example.com
openssl x509 -in leaf.pem -noout -checkip 1.2.3.4
openssl x509 -in leaf.pem -noout -ext subjectAltName

据 RFC 5280,主机名匹配以 SAN 的 dNSName 为准;Chrome 58+ 已完全忽略 CN 字段。通配符 *.example.com 按 RFC 6125 与 RFC 9525 只匹配一级标签,既不匹配 a.b.example.com,也不匹配裸域 example.com。另外,据 Let’s Encrypt 文档,单张证书默认最多包含 100 个 SAN,超限要拆成多张证书,否则签发阶段就会失败。

第 4 步:区分“服务端链不全”和“客户端信任库过旧”。在服务器本机用系统信任库校验同一域名:

# 用系统 CA 包校验;本机通过而目标客户端失败,说明是客户端信任库问题
curl --cacert /etc/ssl/certs/ca-certificates.crt -I https://www.example.com

如果本机校验通过、目标客户端失败,就应检查该客户端的 CA 包版本、Java 的 cacerts(JDK 17 位于 $JAVA_HOME/lib/security/cacerts,默认口令 changeit)、Windows 的 certlm.msc →「受信任的根证书颁发机构」,以及 Android 的「受信任的凭据」。特别注意:Android 7 及以后,用户手动安装的 CA 默认不被 App 信任,需要在 network_security_config.xml 里显式声明。

第 5 步:分发私有 CA 或企业代理根证书。各平台信任库的路径和生效命令完全不同,用错位置是最常见的返工原因:

运行环境 信任库位置或变量 生效命令
Debian、Ubuntu /usr/local/share/ca-certificates/*.crt update-ca-certificates
RHEL 9、CentOS Stream /etc/pki/ca-trust/source/anchors/ update-ca-trust extract
Windows 本地计算机 → 受信任的根证书颁发机构 certutil -addstore -f Root corp-root.crt
Java(JDK 17) $JAVA_HOME/lib/security/cacerts keytool -importcert -alias corp-root -file corp-root.crt -keystore $JAVA_HOME/lib/security/cacerts
Python requests certifi 的 cacert.pem export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt
Go 1.20+ 系统池,可被覆盖 SSL_CERT_FILE=/path/ca.pem ./app
Node.js 系统池,并做追加 NODE_EXTRA_CA_CERTS=/path/ca.pem node app.js

第 6 步:回归三类客户端后再上线。只修好浏览器并不算修好。至少回归三类客户端:命令行(curl 与 openssl s_client -verify_return_error)、目标浏览器(含移动端)、业务运行时(Java、Python、Go、Node)。NODE_EXTRA_CA_CERTS 是追加而不是替换,这一点与 Go 的 SSL_CERT_FILE 不同:后者会整体替换系统池,配错会把公共 CA 一起弄丢。据 Mozilla CA 证书计划的要求,根证书的下发也应通过 GPO 或配置管理完成,手工导入只能作为临时手段。

服务端与客户端怎么配?Nginx、Apache、curl、keytool 命令示例

证书链本身没问题,为什么换到 Nginx 或某台 Java 机器上还是报 ssl证书不受信任?八成是服务端没把中间证书发全,或客户端信任库里没有你的根。下面按”服务端配置 → 命令行验证 → 客户端信任库”三层给出可直接复制的片段。

Nginx 1.20/1.24 怎么配?fullchain 里到底放什么?顺序是站点证书在前、中间证书在后,根证书不要放——客户端自己就有根,多发反而增加握手字节数(RFC 8446 建议证书列表只含必要的链)。ssl_trusted_certificate 只用于 OCSP stapling 时验证链,不会发给客户端,所以填”中间证书”即可。

# /etc/nginx/conf.d/example.com.conf  (Nginx 1.20 / 1.24 通用)
server {
    listen 443 ssl;
    server_name www.example.com;

    ssl_certificate           /etc/nginx/ssl/example.com.fullchain.pem;  # 站点证书 + 中间证书
    ssl_certificate_key       /etc/nginx/ssl/example.com.key;            # 私钥,权限 600
    ssl_trusted_certificate   /etc/nginx/ssl/example.com.chain.pem;      # 仅 OCSP stapling 用,不发给客户端
    ssl_protocols             TLSv1.2 TLSv1.3;                           # 默认值仅 TLSv1.2/1.3(1.23.4+)
    ssl_stapling              on;
    ssl_stapling_verify       on;
}
# 合并顺序:cat example.com.crt example.com.chain.pem > example.com.fullchain.pem
# 校验并热加载,nginx -t 通过后再 reload
nginx -t && systemctl reload nginx

Apache 2.4.52 呢?据 Apache HTTP Server 2.4 文档,SSLCertificateChainFile 自 2.4.8 起已弃用,2.4.52 应把中间证书直接拼进 SSLCertificateFile,否则会出现 AH02032: Hostname ... provided via SNI and hostname ... provided via HTTP are different 之外的链不完整告警。

# /etc/httpd/conf.d/ssl.conf  (Apache 2.4.52)
SSLCertificateFile      /etc/httpd/ssl/example.com.fullchain.pem   # 站点证书 + 中间证书合并
SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
# SSLCertificateChainFile 已弃用,勿再单独指定
apachectl configtest && systemctl reload httpd

curl 怎么确认不是”看起来正常”?退出码才是判据:0 且出现 SSL certificate verify ok 才算通过,60 就是证书验证失败(Peer certificate cannot be authenticated with given CA certificates)。

curl -vI https://www.example.com --cacert /etc/ssl/certs/ca-certificates.crt
# 绕过 DNS,直连指定 IP 测试(SNI 仍按主机名发送)
curl --resolve www.example.com:443:203.0.113.10 -I https://www.example.com
echo $?   # 0=通过,60=证书不受信任,35=握手失败

OpenSSL 3.0 离线怎么验链?-untrusted 传中间证书,缺了就会报 unable to get local issuer certificate:

openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted example.com.chain.pem 
  -verify_hostname www.example.com example.com.crt
# 期望输出:example.com.crt: OK

Java 里自建根证书怎么进信任库?注意 -cacerts 是 JDK 9 才引入的快捷选项,Java 8 必须显式写 -keystore 路径:

# Java 11+(cacerts 位于 $JAVA_HOME/lib/security/cacerts)
keytool -importcert -trustcacerts -cacerts -alias corp-root -file corp-root.crt -storepass changeit
keytool -list -cacerts -alias corp-root        # 验证条目存在

# Java 8u301(位于 $JAVA_HOME/jre/lib/security/cacerts,默认口令 changeit)
keytool -importcert -trustcacerts -alias corp-root -file corp-root.crt 
  -keystore "$JAVA_HOME/jre/lib/security/cacerts" -storepass changeit
# 导入后必须重启 JVM,cacerts 只在启动时读取一次
客户端 信任库位置 导入/刷新命令
Windows certlm.msc → 受信任的根证书颁发机构 certutil -addstore -f Root corp-root.crt
Debian/Ubuntu /etc/ssl/certs/ca-certificates.crt 拷入 /usr/local/share/ca-certificates/ 后 update-ca-certificates
Node.js 启动时读取额外 PEM NODE_EXTRA_CA_CERTS=/path/corp-root.crt node app.js
Python requests 指向合并后的 PEM 包 REQUESTS_CA_BUNDLE=/path/bundle.pem python app.py

最后提醒一个高频坑:ssl_certificate 指向的 fullchain 若把根证书也拼进去,多数浏览器容忍,但部分 Java 8 与旧版 Android 会因链过长或顺序异常直接判为不受信任——这正是”同一张证书在 Chrome 正常、在 App 内报 ssl证书不受信任”的典型成因,排查时先 openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts 数一数服务端到底发了几张证书。

根证书与证书类型怎么选?Let's Encrypt、OV、EV、CFCA 与私有 CA 对比表

选根证书之前,先回答一个问题:访问你站点的到底是哪台设备?绝大多数“ssl 证书不受信任”的告警,问题都不在证书本身,而在于签发链顶端的根证书没有出现在客户端信任库里。据 Let’s Encrypt 文档(《Chain of Trust》),其主力根为 ISRG Root X1(RSA 4096)与 ISRG Root X2(ECDSA P-384),Chrome、Firefox、Safari 与 Android 7.1+ 均已内置;而 Android 7.0 及以下系统不信任 ISRG Root X1,只能依赖 DST Root CA X3 的交叉签名,该交叉签名已于 2024 年 9 月 30 日到期。这就是老设备上浏览器提示 ssl 证书不受信任的直接原因,也是选型必须先列一张“客户端清单”的理由。

方案 根/链特征 默认受信范围 价格区间(元/年) 适用场景
Let’s Encrypt DV ISRG Root X1/X2,90 天 现代浏览器与 Android 7.1+ 0 公开站点、自动化
商业 DV 通配符 老牌根,1 年 覆盖较广 300–1500 多子域、运维简单
商业 OV 单域名 DigiCert/Sectigo 等根 企业对外 800–4000 官网、登录页
EV 单域名 老根 + 组织信息 浏览器 UI 差异已弱化 3000–10000 金融、政企展示
CFCA OV/国密 CFCA 根 / 国密 SM2 国内生态与国密改造 1000–5000 政企、信创
私有 CA 自建根 仅导入过的客户端 软件 0,人力另计 内网、微服务

免费的 Let’s Encrypt 是不是“不够受信任”?不是。据 Let’s Encrypt 官方文档,它与付费 OV 在受信任机制上没有本质区别:都是标准 X.509 链到公共根,浏览器只验证链能否到达受信根。RFC 5280 第 6 节的证书路径验证算法并不区分 DV/OV/EV。真正的差异在验证方式(DV 只验域名控制权,OV 需组织验证)、责任保障、根证书年龄对旧设备的覆盖度,以及有效期(90 天 vs 1 年)。

私有 CA 能不能直接自签一张 leaf 上线?不建议。自签 leaf 没有可分发的最小信任锚,换证书就得全网重新导入,否则每台机器都会报 self signed certificate。正确结构是根 CA → 中间 CA → leaf,客户端只信任根。以下命令适用于 OpenSSL 3.0(-addext 需 1.1.1+,默认摘要已是 SHA-256):

# 1) 建根 CA:pathlen:1 允许且仅允许一级中间 CA(RFC 5280 约束)
openssl req -x509 -newkey rsa:3072 -sha256 -days 3650 -nodes 
  -keyout rootCA.key -out rootCA.crt 
  -subj "/C=CN/O=Example Internal/CN=Example Internal Root CA R1" 
  -addext "basicConstraints=critical,CA:TRUE,pathlen:1" 
  -addext "keyUsage=critical,keyCertSign,cRLSign"

# 2) 中间 CA:CSR 由根签发,pathlen:0 表示只能签 leaf
openssl req -newkey rsa:3072 -nodes -keyout inter.key -out inter.csr 
  -subj "/C=CN/O=Example Internal/CN=Example Internal Issuing CA R1"
openssl x509 -req -in inter.csr -CA rootCA.crt -CAkey rootCA.key 
  -CAcreateserial -days 1825 -sha256 -out inter.crt 
  -extfile <(printf "basicConstraints=critical,CA:TRUE,pathlen:0nkeyUsage=critical,keyCertSign,cRLSignn")

# 3) 自检:期望输出 server.crt: OK
openssl verify -CAfile rootCA.crt -untrusted inter.crt server.crt

根证书必须通过 GPO(certutil -addstore -f Root rootCA.crt)、MDM(Intune/Jamf)或配置管理下发;漏掉一台设备,那台设备就会复现 ssl 证书不受信任。Mozilla 的根证书策略与 CCADB 也说明:根进入信任库需要审计与时间,这正是私有根“天生不受信”的根本原因。

价格不等于成本。免费 DV 的隐性成本是 90 天续期与到期监控(ACME 客户端、告警链路);商业 OV/EV 的隐性成本是组织验证材料、联系人电话核验和重签流程。按 3 年折算 TCO 时,把自动化脚本、监控告警和人工验收工时一并计入,结论往往与标价相反。

常见报错怎么修?unable to get local issuer certificate、PKIX 与 ERR_CERT_AUTHORITY_INVALID

Q:curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate,第一步查什么?

这条报错说明客户端把服务端发来的证书链走到了尽头,却始终没碰到本地信任库里的根。按 RFC 5280 的路径构建规则,90% 的情况是两种:服务端只下发了叶子证书、没带中间证书;或客户端 CA bundle 太旧,不认识新的根(如 ISRG Root X1 交叉签名到期后的老系统)。先看服务端到底发了几个证书:

# 打印服务端下发的证书链;只出现 1 个 s: 就说明缺中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -E '^ *[0-9]+ s:|i:'
# 期望输出形如:0 s:CN=example.com  /  1 s:CN=R11  /  2 s:C=US, O=Let's Encrypt

确认缺证书就把中间证书补进 Nginx 的 ssl_certificate(Let’s Encrypt 文档明确要求用 fullchain.pem 而非 cert.pem)。若服务端已正确下发,则是客户端 bundle 过期,Debian/Ubuntu 执行 apt-get install -y ca-certificates && update-ca-certificates,RHEL/CentOS 执行 update-ca-trust(bundle 分别位于 /etc/ssl/certs/ca-certificates.crt 与 /etc/pki/tls/certs/ca-bundle.crt)。只想临时验证链本身,可用 curl --cacert chain.pem https://example.com,不污染系统信任库。

Q:openssl verify 报 unable to verify the first certificate 是怎么回事?

因为 openssl verify 默认只读 -CAfile,不会自己去服务器上抓中间证书。用 -untrusted 显式提供中间链即可复现浏览器的真实判断:

# 顺序必须是 leaf 在前、intermediate 在后,与 fullchain.pem 一致
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted chain.pem cert.pem
# 成功输出:cert.pem: OK

要强调:根证书不应由服务端下发。服务端下发根证书属于多余且增加握手字节,客户端必须本地信任根;反之漏发中间证书,移动端和 Java 客户端几乎必挂。

Q:Java 报 PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target 怎么修?

JVM 不读系统 CA,只读自己的 $JAVA_HOME/lib/security/cacerts(默认口令 changeit)。据 Oracle keytool 文档,先确认根是否已在库中,再导入:

# 1) 查是否已有该根证书别名(别名大小写不敏感)
keytool -list -cacerts -storepass changeit | grep -i "isrg|corp-root"

# 2) 导入企业根/新根;-cacerts 等价于 -keystore $JAVA_HOME/lib/security/cacerts
keytool -importcert -cacerts -alias corp-root-2024 
  -file corp-root.crt -storepass changeit -noprompt
# 导入后必须重启 JVM,运行中的进程不会重新加载 keystore

常见错误是只导入 leaf 证书——叶子证书 90 天就轮换,下次续期又报同样的错,应导入签发它的根或中间 CA。

Q:Chrome 的 ERR_CERT_AUTHORITY_INVALID、ERR_CERT_COMMON_NAME_INVALID、ERR_CERT_DATE_INVALID 分别代表什么?

  • ERR_CERT_AUTHORITY_INVALID:根不受信,典型是企业代理做了 TLS 中间人替换证书,或自签根未推送到客户端。Chrome 96+ 可在 chrome://net-internals/#events 查看完整的证书验证事件。
  • ERR_CERT_COMMON_NAME_INVALID:证书 SAN 不含你访问的域名。CN 字段自 Chrome 58 起已被忽略,只看 SAN。
  • ERR_CERT_DATE_INVALID:证书过期,或客户端系统时间偏差超出 notBefore/notAfter 区间。

Q:Nginx 配好了还是不受信任,怎么定位?

先确认加载的文件,再确认 SNI 命中的是哪个 server 块。RFC 6066 定义的 SNI 不匹配时,Nginx 会退回 default_server 的证书,报错看起来就像”证书不对”:

# 1) 看实际加载的路径,应为 fullchain.pem
nginx -T | grep -n "ssl_certificate"
# 2) 指定 SNI 复测,对比不带 -servername 的结果
openssl s_client -connect 127.0.0.1:443 -servername example.com /dev/null 
  | openssl x509 -noout -subject -issuer -ext subjectAltName

Q:Python requests 报 SSLError: certificate verify failed: unable to get local issuer certificate?

requests 依赖 certifi 包内置的 cacert.pem,不读系统 CA,所以系统里装好了它照样报错。用环境变量覆盖或把私有根合并进 certifi:

# 方案一:指向系统 bundle(requests 2.x 会优先读该变量)
export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt
# 方案二:合并进 certifi,路径可用 python -c "import certifi;print(certifi.where())" 获取
cat corp-root.crt >> "$(python -c 'import certifi;print(certifi.where())')"
客户端 信任库位置 覆盖方式
curl / OpenSSL /etc/ssl/certs/ca-certificates.crt(Debian 系) --cacert 或 CURL_CA_BUNDLE
Java $JAVA_HOME/lib/security/cacerts,口令 changeit keytool -importcert -cacerts,或 -Djavax.net.ssl.trustStore
Python requests certifi 的 cacert.pem REQUESTS_CA_BUNDLE
Node.js 编译期内置根列表 NODE_EXTRA_CA_CERTS(Node 7.3+)
Go 系统信任库 SSL_CERT_FILE / SSL_CERT_DIR

排查顺序建议固定为:先用 openssl s_client -showcerts 判定是”服务端链不全”还是”客户端库不认”,两者修复位置完全不同;再对照上表找到该客户端的信任库,避免在服务端反复折腾却始终解决不了某个特定运行时的 ssl证书不受信任 报错。

改完如何验证 SSL 证书已受信任?openssl、curl、Java 与移动端验收清单

改完证书链、换了 CA 或更新了服务端配置,最危险的状态是”自己电脑上浏览器不报错”。真正的验收要覆盖四层:服务端下发的链、命令行客户端、应用运行时信任库、真机与持续监控。下面这套清单可以直接照抄。

第一步:openssl 看服务端到底发了什么链

# -servername 必须显式带 SNI,否则多域名 CDN 可能返回默认站点证书
# -verify_return_error:验证失败立即终止握手,比只看文本更严格
openssl s_client -connect www.example.com:443 
  -servername www.example.com 
  -verify_return_error &1 | grep -E 'Verify return code|^ *[0-9]+ s:'

# 期望输出(OpenSSL 3.x 默认已开启验证,1.1.1 需显式加 -verify_return_error)
# Verify return code: 0 (ok)
# 1 s:CN = www.example.com          ← 叶证书
# 2 s:C = US, O = Let's Encrypt...  ← 中间证书

据 OpenSSL 官方文档,Certificate chain 应包含 2–3 张证书(叶证书 + 中间证书,根证书一般不随链下发,由客户端本地信任库补齐)。若出现 verify error:num=20:unable to get local issuer certificate,说明服务端漏发中间证书;num=21:unable to verify the first certificate 通常是链顺序错误或根缺失。

第二步:curl 快速回归,脚本可批量跑

# 期望输出 "200 0":HTTP 200 且证书验证通过
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://www.example.com

# 若返回 60(CURLE_PEER_FAILED_VERIFICATION),用 -v 定位具体原因
curl -vI https://www.example.com 2>&1 | grep -iE 'SSL certificate|subject:|issuer:|expire'

# 区分"链本身有问题"还是"本机 ca-certificates 太旧":
curl --cacert ./fullchain.pem -sS -o /dev/null -w '%{ssl_verify_result}n' https://www.example.com

第三步:Java 最容易踩坑,必须按运行时版本各测一次

# 能打印出 2 段以上 "Certificate[n]:" 说明链完整
keytool -printcert -sslserver www.example.com:443 | grep -E 'Certificate[|Owner:|Issuer:'

# 显式指定信任库启动,再跑一次真实业务请求
java -Djavax.net.ssl.trustStore=/path/to/cacerts 
     -Djavax.net.ssl.trustStorePassword=changeit -jar app.jar

典型报错:sun.security.validator.ValidatorException: PKIX path building failed: unable to find valid certification path to requested target,含义就是中间证书缺失或根不在该 JDK 的 cacerts 里。Java 8u301 与 Java 17 的默认信任库版本不同,只测开发机等于没测。

第四步:浏览器、SSL Labs 与真机横向对照

客户端 验收方式 通过标准 典型失败信息
OpenSSL s_client -servername Verify return code: 0 (ok) num=20 unable to get local issuer certificate
curl -w '%{ssl_verify_result}' 200 0 60 peer certificate cannot be authenticated
Java keytool -printcert -sslserver 打印 ≥2 段 Certificate PKIX path building failed
SSL Labs 在线扫描 A/A+,Chain issues: None Chain incomplete / Extra certs

Chrome DevTools → Security 面板应显示 Certificate valid;据 Qualys SSL Labs 评分规则,还要顺带确认 Certificate Transparency 与 OCSP stapling 是否生效。真机至少覆盖 Android 7.0/7.1、iOS 12+、以及已更新根证书的 Windows 7——老 Android 不信任 ISRG Root X1,这正是 Let’s Encrypt 交叉签名链存在的原因。

第五步:把验收变成监控,而不是一次性动作

# Prometheus blackbox_exporter:证书剩余有效期 < 14 天告警
probe_ssl_earliest_cert_expiry - time() < 14 * 86400

# 每周跑一次续期演练,确认 hook 与权限没问题
certbot renew --dry-run

# 每 5 分钟拨测,非 0 即告警
openssl s_client -connect www.example.com:443 -servername www.example.com 
  -verify_return_error &1 | grep -q 'Verify return code: 0 (ok)' || echo ALERT

只有把这五层都跑通,才能说”ssl证书不受信任”这个问题真正闭环了;任何一层缺失,故障都会在下一次客户端升级或根证书过期时重新出现。

不一定。过期只对应 ERR_CERT_DATE_INVALID;更常见的是客户端根证书信任库没有对应根、SNI/域名不匹配、服务端缺中间证书或企业代理替换证书。先用 openssl s_client -verify_return_error 看返回码,再分客户端排查。

浏览器可能通过 AIA 自动补链或使用系统/内置根,curl 只读 –cacert 或 /etc/ssl/certs/ca-certificates.crt。服务端补全 fullchain,客户端更新 ca-certificates,或临时用 curl –cacert chain.pem 验证。

机制上都走公共根,现代浏览器都信任;差异在旧设备根覆盖、组织验证、责任保障和有效期。Let's Encrypt 90 天适合自动化,OV 通常 1 年并含企业信息核验,价格约 800-4000 元/年。

这是 JVM 的 cacerts 找不到可信路径。用 keytool -importcert -cacerts -alias corp-root -file corp-root.crt 导入根证书,确认 Java 8 的 jre/lib/security/cacerts 或 Java 11+ 的 lib/security/cacerts,重启应用后复测。

不要分发 leaf,建立私有根 CA 和中间 CA,把根证书通过 GPO、MDM、配置管理工具推到 Windows/Linux/macOS/Java 信任库。Linux 用 update-ca-certificates,Windows 用 certutil -addstore -f Root,Java 用 keytool -importcert。

先确认 nginx -T 实际加载的是 fullchain,且 server_name/SNI 命中的不是默认站点;再用 openssl s_client -servername 域名复测。若链正确但客户端仍报错,查客户端根证书、系统时间和代理设置。

不是。证书不受信任是 TLS 握手/证书验证失败,页面通常直接拦截;混合内容是 HTTPS 页面加载 HTTP 资源,证书本身有效但浏览器提示“不安全”。前者查证书链和信任库,后者查页面资源 URL。


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

内容审核

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