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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。