SSL 证书报错怎么办?从根因定位到 Nginx/Apache 修复与验证的完整排查指南
SSL 证书报错先读错误码:线上约七成集中在证书过期、证书链不完整、域名与 SAN 不匹配三类,用 openssl s_client -connect 域名:443 -servername 域名 -showcerts 一条命令可在 1 分钟内定位。 Nginx 的 ssl_certificate 必须指向 fullchain.pem(站点证书+中间证书),只配 cert.pem 会让 curl、Java、Android 报 unable to get local issuer certificate。 Let's Encrypt 证书有效期 90 天,certbot 2.x 默认在剩余 30 天续期;务必用 certbot renew --dry-run 验证定时任务,否则第 91 天必然报 NET::ERR_CERT_DATE_INVALID。 TLS 配置以 Mozilla SSL Configuration Generator 的 intermediate 档为基线:ssl_protocols TLSv1.2 TLSv1.3,ssl_prefer_server_ciphers off,HSTS max-age 先设 300 秒再逐步加到 31536000。 验证阶段用 openssl s_client -verify_return_error 看 Verify return code: 0 (ok),再用 testssl.sh --fast 或 SSL Labs 复核链、协议与 OCSP。
SSL 证书报错通常由什么引起?先分清 6 类根本原因
遇到 ssl证书报错怎么办?第一反应往往是重启 Nginx,但真正高效的定位顺序是先读客户端错误码,再回到服务端复现。浏览器给出的每一个码都精确对应一条校验失败路径:Chrome 126 的 NET::ERR_CERT_DATE_INVALID 落在有效期校验,NET::ERR_CERT_AUTHORITY_INVALID 落在信任链构建(RFC 5280 §6 的路径验证),Firefox 的 SSL_ERROR_BAD_CERT_DOMAIN 与 Chrome 的 NET::ERR_CERT_COMMON_NAME_INVALID 则落在标识符匹配(RFC 6125,现由 RFC 9525 更新)。按这张映射表分诊,比盲改配置快一个数量级。
| 客户端报错 | 根因类别 | 一条命令验证 |
|---|---|---|
NET::ERR_CERT_DATE_INVALID |
过期 / 服务器时间漂移 | openssl x509 -noout -dates |
NET::ERR_CERT_AUTHORITY_INVALID |
证书链不完整 / 自签根 | openssl s_client -showcerts |
NET::ERR_CERT_COMMON_NAME_INVALID |
SAN 不含该域名 | openssl x509 -noout -ext subjectAltName |
ERR_SSL_VERSION_OR_CIPHER_MISMATCH |
协议版本或套件不匹配 | openssl s_client -tls1_2 |
curl: (60) unable to get local issuer certificate |
链不完整(客户端无 AIA 补链) | curl -vI https://… |
PKIX path building failed |
Java cacerts 缺根证书 / 企业代理解密 | keytool -list -cacerts |
1. 过期类占线上报修的大头。据 Let’s Encrypt 文档,其证书有效期固定 90 天,续期完全依赖自动化:certbot 靠 systemd timer,acme.sh 靠 crontab。任一环节断了,90 天后必然报错。
# 看服务端实际下发的证书有效期(注意 -servername 触发 SNI)
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -dates -subject
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=May 30 00:00:00 2025 GMT
# 续期定时任务是否还活着
systemctl list-timers | grep certbot # certbot 默认安装 certbot.timer
crontab -l | grep acme.sh # acme.sh 默认写入 root 的 crontab
timedatectl # 系统时间漂移 >5 分钟会让 ACME 校验和客户端校验同时失败
2. 证书链不完整。Nginx 只写站点证书、漏拼中间证书时,Chrome 会通过证书里的 AIA 字段自动补链,所以你本地看着“正常”;但 curl 8.x(依赖系统 CA bundle,不做 AIA 抓取)、Java 17、老版本 Android 会直接失败。修复方式是让 Nginx 的 ssl_certificate 指向 fullchain.pem(站点证书在上、中间证书在下),Apache 2.4.8 之后同样直接把 fullchain 交给 SSLCertificateFile,不再需要 SSLCertificateChainFile。
3. 域名不匹配。证书 SAN 只有 example.com 时,访问 www.example.com 即报 ERR_CERT_COMMON_NAME_INVALID;通配符 *.example.com 按 RFC 6125 只覆盖一级子域,不覆盖 a.b.example.com。签发前用 -d example.com -d www.example.com 显式列出更稳妥。
4. 协议与套件不匹配。服务端只留 TLSv1.3、或把 RSA 套件从 ssl_ciphers 里删掉,只支持 RSA 证书的老终端就会报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。下面这条命令可直接复现:
# 强制用 TLS1.2 + 单个 RSA 套件握手,失败会输出 handshake failure / no peer certificate available
openssl s_client -connect example.com:443 -servername example.com
-tls1_2 -cipher 'ECDHE-RSA-AES128-GCM-SHA256' </dev/null
5. 信任库与中间设备。Java 的 cacerts 未导入根证书、企业代理做 SSL 解密后重签、CDN 边缘证书过期,都会出现“源站自测正常、用户却报错”。排查时先绕过 DNS 直连源站,再对比 CDN 边缘下发的证书序列号与有效期是否一致:
curl -vI --resolve example.com:443:203.0.113.10 https://example.com # 直连源站
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -serial -dates # CDN 边缘实际下发的证书
先分清这 6 类,再决定是改配置、补链、续期还是找 CDN 厂商——这是回答“ssl证书报错怎么办”最省时间的第一步。
SSL 证书报错怎么一步步修?6 步标准处置流程
遇到 ssl 证书报错怎么办?先别急着换证书。生产环境里 90% 的“证书报错”其实只有三类根因:服务器时间漂移、证书链缺中间证书、访问域名不在 SAN 里。下面这套 6 步流程按“先取证、再定位、后修复、最后防复发”的顺序排列,每一步都有可直接复制的命令。
-
步骤 1|固定现场,先看时间。记录完整 URL、错误码、客户端版本(Chrome 126 / curl 8.5 / Java 17)和发生时间(精确到分钟)。然后登录服务器执行:
# 证书有效性校验完全依赖本地时钟,据 RFC 5280 §4.1.2.5 date -u # 期望接近真实 UTC,如 Thu 2024-06-13 08:21:07 UTC timedatectl # 关注 "System clock synchronized: yes" 与 "NTP service: active" # 偏差超过 300 秒时,先修 NTP,再谈证书 sudo timedatectl set-ntp true sudo chronyc makestep # chrony 环境立即跳变对齐;systemd-timesyncd 用 timedatectl 即可时间偏差会让浏览器抛
NET::ERR_CERT_DATE_INVALID、curl 抛certificate is not yet valid,此时证书本身完全没问题。 -
步骤 2|从外部探测真实下发的证书。绕开浏览器缓存,直接看服务器实际返回了什么:
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -dates -subject -issuer -ext subjectAltName # 输出关注三处:notAfter=(到期日)、issuer=(是否你申请的 CA)、DNS:(SAN 列表) # 注:-ext 需 OpenSSL 1.1.1+;1.0.2 请改用 -text 后人工查找如果
issuer不是你的 CA,说明 SNI 落到了别的 server 块(默认站点),这是多域名 Nginx 最常见的“证书装对了但报错”场景。SAN 缺失会触发ERR_CERT_COMMON_NAME_INVALID——Chrome 58 起已不再回退读取 CN,依据是 CA/Browser Forum 基线要求与 RFC 6125。 -
步骤 3|验证证书链是否完整。把链下载为
fullchain.pem后本地校验:openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem # 返回 fullchain.pem: OK → 链完整,问题不在证书 # 返回 unable to get local issuer certificate → 缺中间证书,补 chain 后重拼据 Let’s Encrypt 文档,其
fullchain.pem已含中间证书,若你手工只上传了cert.pem,就必然报这个错。 -
步骤 4|修正服务端配置。Nginx 的关键是“站点证书在前、中间证书在后”拼进同一文件:
server { listen 443 ssl; server_name www.example.com; ssl_certificate /etc/letsencrypt/live/www.example.com/fullchain.pem; # 站点证书+中间证书 ssl_certificate_key /etc/letsencrypt/live/www.example.com/privkey.pem; } # 校验语法再平滑重载,切勿直接 restart 中断连接 nginx -t && systemctl reload nginxApache 2.4.8 及以上用
SSLCertificateFile指向 fullchain 即可,SSLCertificateChainFile已废弃,同时配置反而可能引起链重复。 -
步骤 5|多客户端复测,别只信 Chrome。
curl -Ivs https://www.example.com --resolve www.example.com:443:1.2.3.4 2>&1 | grep -E "SSL certificate verify|subject:|expire" # 期望输出:SSL certificate verify ok. java_home/bin/keytool -list -cacerts -storepass changeit | grep -i "isrg|digicert"客户端 验证方式 通过标志 典型报错 Chrome 126 DevTools → Security “连接安全”、链完整 ERR_CERT_AUTHORITY_INVALID curl 8.5 (OpenSSL 3.x) 上条 –resolve 命令 SSL certificate verify ok. unable to get local issuer certificate Java 17 keytool -list -cacerts 信任库含目标根 CA PKIX path building failed Android 7.1 模拟器 系统浏览器直访 无警告 老系统缺 ISRG Root X1 交叉签名 -
步骤 6|防复发:演练续期 + 指纹留痕。
certbot renew --dry-run # 演练续期,不写盘、不重载 acme.sh --cron --home /root/.acme.sh # acme.sh 的等价定时任务 openssl x509 -in fullchain.pem -noout -fingerprint -sha256 # 记入变更单,重载后核对Let’s Encrypt 证书有效期 90 天,官方建议剩余 30 天续期;把监控告警阈值设成剩余 21 天,留出人工介入窗口。指纹前后一致才算重载成功,否则说明 reload 未生效或配置指向了旧文件。
Nginx、Apache、Tomcat 怎么配?可直接复制的命令与参数示例
前面定位完根因,真正落到服务器上就是几行配置的事。但恰恰是这几行,写错一个参数就会出现 SSL_ERROR_RX_RECORD_TOO_LONG 或浏览器报 NET::ERR_CERT_AUTHORITY_INVALID。下面按 Web 服务器分三类给出可直接复制的配置,参数均标注默认值与适用范围。
Nginx 1.24.0 + OpenSSL 3.0.x 的最小可用配置
把以下片段放进 server { listen 443 ssl; ... } 块内。ssl_certificate 必须指向 fullchain(叶子证书 + 中间证书),只配叶子证书是最常见的”证书链不完整”报错来源,Android 与 Java 客户端会直接拒绝握手。
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+ 写法;1.24 及更早用 listen 443 ssl http2;
server_name example.com www.example.com;
# fullchain = 站点证书 + 中间证书;chain.pem 仅用于 OCSP 装订校验
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
ssl_protocols TLSv1.2 TLSv1.3; # 默认值 TLSv1 TLSv1.1 TLSv1.2(1.23 起默认 TLSv1.2 TLSv1.3)
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305';
ssl_prefer_server_ciphers off; # 默认 off,让客户端选,符合 Mozilla 推荐配置
ssl_session_cache shared:SSL:10m; # 默认 none;10m 约缓存 4 万个会话
ssl_session_timeout 1d; # 默认 5m
ssl_session_tickets off; # 默认 on,关掉可提升前向安全性
ssl_stapling on;
ssl_stapling_verify on;
resolver 1.1.1.1 8.8.8.8 valid=300s;
resolver_timeout 5s;
}
改完务必先语法检查再热加载,nginx -t 失败时 reload 不会生效,容易误以为”已修复”:
nginx -t && systemctl reload nginx # -t 只校验不生效,reload 不中断连接
Apache 2.4.57 的对应写法
Apache 把证书链与私钥合并进 SSLCertificateFile 即可(2.4.8 起支持),无需再单独写 SSLCertificateChainFile(该指令在 2.4.8 后已弃用)。OCSP 装订缓存必须定义在全局作用域,写在 VirtualHost 里会启动失败。
# 全局作用域(httpd.conf 或 ssl.conf 顶层)
SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
SSLUseStapling on
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
apachectl configtest && systemctl reload apache2 # Debian/Ubuntu;RHEL 系为 httpd
Tomcat 9.0.x / 10.1.x:JVM 信任库与 PKCS12
Java 客户端的证书报错往往不是服务器配置错,而是 JVM 不认 Let’s Encrypt 的 ISRG Root X1(旧版 JDK 8u141 之前缺失)。据 Let’s Encrypt 文档,交叉签名链已于 2024 年 9 月到期,因此需要手动导入根证书:
keytool -importcert -alias isrgrootx1 -file isrgrootx1.pem
-keystore $JAVA_HOME/lib/security/cacerts -storepass changeit
# 默认口令即 changeit;导入后可用 keytool -list -keystore ... 校验
Connector 配置使用 PKCS12(JDK 9 起为默认密钥库格式,JKS 已不推荐):
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" scheme="https" secure="true"
keystoreFile="/opt/tomcat/conf/keystore.p12"
keystoreType="PKCS12" keystorePass="强密码"
sslEnabledProtocols="TLSv1.2,TLSv1.3" />
Java 17 的 jdk.tls.disabledAlgorithms 默认已禁用 TLSv1 与 TLSv1.1,若仍显式开启会抛 SSLHandshakeException: No appropriate protocol。
签发与自检:三组命令确认配置真的生效
证书签发(Let’s Encrypt 遵循 ACME RFC 8555,证书有效期 90 天):
# certbot 2.10
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
--deploy-hook 'systemctl reload nginx'
# acme.sh 3.0
acme.sh --issue -d example.com -d www.example.com --nginx --server letsencrypt
没有 ACME 客户端时可用 OpenSSL 手工生成 CSR(-addext 需 OpenSSL 1.1.1+,RSA 2048 与 ECDSA P-256 均可):
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj '/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
部署后的三条验证命令,分别对应 SAN、证书链顺序、协议兼容性:
openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
openssl s_client -connect example.com:443 -servername example.com -tls1_2
-cipher 'ECDHE-RSA-AES128-GCM-SHA256'
三条命令的输出分别能看出:域名是否漏配 www、链中每张证书的 subject/issuer 顺序是否正确(顺序颠倒会报 unable to verify the first certificate)、以及老客户端能否完成 TLS 1.2 握手。当 ssl证书报错怎么办 排查到这一步,剩下的基本就是客户端缓存或 DNS 未切换的问题了。
| 对比项 | Nginx 1.24 | Apache 2.4.57 | Tomcat 9/10.1 |
|---|---|---|---|
| 证书链配置方式 | fullchain.pem 单文件 | fullchain.pem 合并进 SSLCertificateFile | PKCS12 单文件含私钥 |
| 协议开关指令 | ssl_protocols | SSLProtocol | sslEnabledProtocols / JVM 属性 |
| OCSP 装订 | ssl_stapling on | SSLUseStapling + 全局缓存 | 不原生支持 |
| 配置校验命令 | nginx -t | apachectl configtest | 启动日志 + keytool -list |
| 热加载 | systemctl reload nginx | systemctl reload apache2 | 重启 Connector 或整个实例 |
据 Mozilla Server Side TLS 指南,TLS 1.3 的套件由实现固定,ssl_ciphers 只对 TLS 1.2 及以下生效——这也是很多人改了套件却看不到变化的原因。
DV、OV、EV、通配符与免费证书怎么选?一张对比表说清
“我的站点该买哪种证书?免费的够用吗?”——这是排查 ssl证书报错怎么办 时最容易被跳过、却决定了后续 90% 运维工作量的一步。先把选型一次说清,再谈修复。
| 方案 | 适用场景 | 价格区间(元/年) | 有效期 | 运维成本 |
|---|---|---|---|---|
| Let’s Encrypt DV 单域名 | 个人站、API、测试环境 | 0 | 90 天 | 需自动续期 |
| 商业 DV 单域名 | 中小企业官网 | 100–500 | 398 天 | 低 |
| DV 通配符 | 多子域统一入口 | 600–1500 | 398 天 | 中 |
| OV 单域名 | 电商、登录页、B 端 | 1500–4000 | 398 天 | 需单位资料 |
| EV 单域名 | 金融、政务展示 | 4000–10000 | 398 天 | 高,需审核 |
| 多域名 SAN | 多品牌共用一个证书 | 按域名数加价 | 398 天 | 中 |
DV、OV、EV 到底差在哪?差的只是身份核验深度,加密强度完全一样。DV 只校验域名控制权(HTTP-01 / DNS-01),通常 1–10 分钟签发;OV 需营业执照与组织电话核验,约 1–3 个工作日;EV 需扩展核验,约 3–7 个工作日。据 CA/Browser Forum Baseline Requirements,公开信任证书有效期上限为 398 天,这也是商业证书统一标 398 天的原因。需要提醒的是:Chrome 自 77 版起已不再在地址栏显示 EV 的绿色公司名,只为 UI 观感多付几千元预算并不划算。
通配符证书能覆盖根域吗?不能。单域名证书只匹配一个 FQDN;*.example.com 匹配 www.example.com、api.example.com,但不匹配 example.com 本身,也不匹配 a.b.example.com(通配符只吃一级)。要覆盖根域,必须把根域一起写进 SAN:
# 签发通配符证书:-d '*.example.com' 与 -d example.com 必须同时给出
sudo certbot certonly --manual --preferred-challenges dns
-d '*.example.com' -d example.com
--cert-name example.com-wildcard
# 注:DNS-01 需在 DNS 服务商添加 _acme-challenge TXT 记录;
# 生产环境建议改用 certbot-dns-* 插件或 acme.sh 实现全自动
# 确认续期链路可用:返回 0 且输出 "Congratulations" 即正常
sudo certbot renew --dry-run
# 确认 systemd timer 已注册(certbot 包默认安装 certbot.timer)
systemctl list-timers | grep certbot
据 Let’s Encrypt 官方文档,建议在证书剩余 30 天前完成续期,生产环境必须配置 systemd timer 或 cron,否则 90 天周期一到就会出现“证书已过期”报错。Let’s Encrypt 与商业 DV 的信任链是等价的,差别在有效期(90 天 vs 398 天)、SLA 与 OCSP 响应能力。
国密 SM2 能直接上公网吗?不建议。SM2 适用于金融、政务专网,但 Chrome 126 默认不信任 SM2 证书链,只部署 SM2 会让普通浏览器直接报 ERR_CERT_AUTHORITY_INVALID。对外站点需 RSA + SM2 双证书,且官方 Nginx 不支持重复 ssl_certificate 指令,会直接报 nginx: [emerg] duplicate ssl_certificate ...,必须使用 TongSuo 等支持国密的 Nginx 分支。
# 核验证书类型、有效期与 SAN 是否覆盖你的域名(排查选型错配的第一步)
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout
-subject -issuer -dates -ext subjectAltName
# 国密分支 Nginx 双证书写法(官方 Nginx 不支持此语法)
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/ssl/example.com.rsa.crt; # 国际通用
ssl_certificate_key /etc/nginx/ssl/example.com.rsa.key;
ssl_certificate /etc/nginx/ssl/example.com.sm2.crt; # 国密客户端
ssl_certificate_key /etc/nginx/ssl/example.com.sm2.key;
ssl_protocols TLSv1.2 TLSv1.3; # PCI DSS 4.0 要求 TLS 1.2+;具体默认值随 OpenSSL 版本而异
}
选型顺序建议:先看客户端分布——Java 8、Android 5 是否还在你的访问日志里(这决定能否只开 TLS 1.2+);再看合规要求(等保、PCI DSS 均要求 TLS 1.2 以上);最后才看预算。证书价格只占一次线上故障成本的一小部分,自动化续期与到期监控才是决定 ssl证书报错怎么办 时你是否手忙脚乱的关键。
常见 SSL 证书报错原文怎么排查?6 个高频错误逐条对照
浏览器只丢一句 NET::ERR_CERT_DATE_INVALID,curl 只丢一句 curl: (60),光看报错文本无法定位根因。下面 6 条是线上出现频率最高的 SSL 证书报错原文,每条都给出定位命令和修复落点,建议按顺序对照排查。
1. NET::ERR_CERT_DATE_INVALID:过期,还是时间不对?
先看证书本身的有效期,再核对两端时钟。据 Let’s Encrypt 文档,其证书有效期固定 90 天,官方建议在剩余 30 天时续期;因此“超过 90 天未续期”是这条报错的头号原因,其次是服务器或客户端系统时间漂移(容器快照恢复、BIOS 电池失效都会导致)。
# 查看证书生效/失效时间,重点看 notAfter
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -dates
# notBefore=Mar 1 00:00:00 2024 GMT
# notAfter=May 30 00:00:00 2024 GMT
date -u # 服务器 UTC 时间,与 notAfter 对比
certbot certificates # 列出各证书剩余天数(Expiry Date)
systemctl list-timers | grep -i certbot # 确认续期定时器是否还活着
2. curl: (60) unable to get local issuer certificate:服务端漏发中间证书
这条报错意味着客户端拿不到完整信任链。用 s_client 数一下服务端到底发了几张证书:返回 1 就是只发了叶子证书。
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -c "BEGIN CERTIFICATE" # 期望 >= 2,只有 1 说明缺中间证书
修复:Nginx 的 ssl_certificate 必须指向 fullchain.pem 而非 cert.pem;Apache 2.4.8 起 SSLCertificateFile 直接指向 fullchain,SSLCertificateChainFile 已废弃;Java 客户端则需用 keytool 把中间证书导入信任库。
3. SSL_ERROR_BAD_CERT_DOMAIN / ERR_CERT_COMMON_NAME_INVALID:SAN 里没有这个域名
按 RFC 6125,现代浏览器只校验 SAN(subjectAltName),完全忽略 CN 字段。
openssl x509 -in fullchain.pem -noout -ext subjectAltName
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:*.example.com
常见误判:通配符 *.example.com 只覆盖一级子域,a.b.example.com 不在其中;它也不覆盖裸域 example.com。必须重新签发并把实际访问的域名写进 SAN。
4. ERR_SSL_VERSION_OR_CIPHER_MISMATCH:协议或套件谈不拢
openssl s_client -connect example.com:443 -tls1_2 </dev/null # 分别验证每个协议版本
openssl s_client -connect example.com:443 -tls1_3 </dev/null
nmap --script ssl-enum-ciphers -p 443 example.com # 枚举实际启用的套件与评级
服务端至少保留 TLSv1.2 与 TLSv1.3,并确保 ECDHE-RSA-AES128-GCM-SHA256 这类前向保密套件可用(参照 Mozilla SSL Configuration Generator 的 Intermediate 配置)。旧客户端连不上时,先确认是协议被裁掉还是套件被裁掉。
5. javax.net.ssl.SSLHandshakeException: PKIX path building failed
Java 17 默认信任库是 $JAVA_HOME/lib/security/cacerts,私发 CA 或中间证书不在其中。导入后必须重启应用,JVM 只在启动时加载信任库:
keytool -importcert -trustcacerts -alias exampleca -file ca.pem
-keystore $JAVA_HOME/lib/security/cacerts -storepass changeit
keytool -list -alias exampleca -keystore $JAVA_HOME/lib/security/cacerts # 验证
6. nginx: [emerg] cannot load certificate “…”: PEM_read_bio_X509_AUX() failed
Nginx 启动即失败,说明证书文件读不进来:不是 PEM 格式、路径写错或权限不足。客户端侧对应的报错是 SSL routines:ssl3_read_bytes:tlsv1 alert unknown ca。
file /etc/nginx/ssl/fullchain.pem # 必须输出 "PEM certificate"
openssl x509 -in fullchain.pem -noout -subject # 能解析才说明格式正确
chmod 600 /etc/nginx/ssl/privkey.pem # 私钥 600,属主为 nginx 运行用户
chown nginx:nginx /etc/nginx/ssl/*.pem
| 报错原文 | 根因 | 一条定位命令 | 修复位置 |
|---|---|---|---|
| ERR_CERT_DATE_INVALID | 证书过期 / 时钟漂移 | openssl x509 -noout -dates |
续期 + NTP 校时 |
| curl: (60) unable to get local issuer | 缺中间证书 | s_client -showcerts |
改用 fullchain.pem |
| ERR_CERT_COMMON_NAME_INVALID | SAN 不匹配 | -ext subjectAltName |
重签并补 SAN |
| ERR_SSL_VERSION_OR_CIPHER_MISMATCH | 协议/套件不兼容 | nmap ssl-enum-ciphers |
ssl_protocols / ssl_ciphers |
| PKIX path building failed | Java 信任库缺链 | keytool -list |
cacerts 导入 CA |
| PEM_read_bio_X509_AUX() failed | 格式/路径/权限 | file fullchain.pem |
改格式 + chmod 600 |
证书链、OCSP 与 HSTS:三个最容易被忽略的细节
为什么 curl 能通,浏览器却报 ERR_CERT_AUTHORITY_INVALID?
九成是证书链顺序错了。握手时服务器必须按 leaf(站点证书)→ intermediate(中间证书) 的顺序发送,且不要把根证书放进 fullchain——根证书客户端本地已内置,多发只会增大握手体积,部分老客户端还会因出现自签根而中断校验。据 Let’s Encrypt 文档,其 fullchain.pem 已包含 leaf + 中间证书,Nginx 直接 ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; 即可;自建 CA 或部分商业证书才需要手工拼接:
# 顺序:站点证书在前,中间证书在后;根证书不要加入
cat cert.pem chain.pem > fullchain.pem
# 校验拼接顺序:第一张证书的 subject 必须是你自己的域名
openssl crl2pkcs7 -nocrl -certfile fullchain.pem
| openssl pkcs7 -print_certs -noout
# 从线上抓取服务端真实发送顺序(-showcerts 按发送顺序输出)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
| 现象/报错 | 根因 | 修复动作 |
|---|---|---|
浏览器 ERR_CERT_AUTHORITY_INVALID,curl 正常 |
只发了 leaf,缺中间证书 | 改用 fullchain.pem |
openssl verify 返回 unable to get local issuer certificate |
链顺序颠倒或中间证书缺失 | 重排为 leaf → intermediate |
Java 客户端 PKIX path building failed |
JDK 未预置该中间证书 | 服务端补全中间证书,勿改客户端 truststore |
OCSP Stapling 怎么配,怎么确认真的生效?
Stapling 让服务器代替客户端去查吊销状态,省掉一次外连,也避免 OCSP 响应慢拖垮首屏。Nginx 默认 ssl_stapling off,需显式开启;resolver 必须写,否则 Nginx 无法解析 OCSP responder 域名:
# Nginx 1.24 实测可用;ssl_stapling 自 1.3.7 起支持
ssl_stapling on;
ssl_stapling_verify on; # 默认 off,开启后会校验响应签名
resolver 223.5.5.5 119.29.29.29 valid=300s; # 缓存 5 分钟
resolver_timeout 5s;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 只放中间证书,用于验证 OCSP 响应
Apache 对应 SSLUseStapling on 与 SSLStaplingCache "shmcb:logs/stapling-cache(150000)"。验证只看一行:openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -A1 "OCSP Response Status",出现 OCSP Response Status: successful (0x0) 才算成功;若是 no response sent,先确认 ssl_trusted_certificate 指向的是中间证书而非 fullchain。
HSTS 能不能一上来就设一年?
不要。HSTS 是”单向阀门”,一旦下发,浏览器在 max-age 内强制走 HTTPS,回滚只能等过期。先短后长:
# 第一阶段:观察 1 周
add_header Strict-Transport-Security "max-age=300" always;
# 稳定后改为(1 年);加 includeSubDomains 前务必确认所有子域都有 HTTPS
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
RFC 6797 明确:includeSubDomains 会作用于所有子域,任何只跑 HTTP 的子域(测试环境、内网面板)都会被锁死。别急着上 preload,那需要向浏览器厂商提交列表,退出周期以月计。
TLS 版本、SNI、CT 还有哪些坑?
- TLS 1.0/1.1 自 2020 年起被 Chrome 84、Firefox 74 陆续禁用,PCI DSS 也要求 TLS 1.2 以上;但 Java 8 早期版本默认只协商到 TLS 1.0,服务端收紧后会报握手失败,升级到 8u321+ 或用
-Djdk.tls.client.protocols=TLSv1.2显式开启。 - SNI 是多域名共用 443 的前提,Nginx 靠
server_name选证书。Windows XP、Java 6 等不支持 SNI 的客户端只会拿到默认证书并报域名不匹配,只能独立 IP 或放弃兼容;测试用openssl s_client -servername a.example.com -connect example.com:443对比默认证书。 - CT 要求公共信任证书携带 SCT,缺失时 Chrome 报
ERR_CERTIFICATE_TRANSPARENCY_REQUIRED。Let’s Encrypt 默认在证书中嵌入 SCT,自签证书无法满足,用openssl x509 -in fullchain.pem -text -noout | grep -c "CT Precertificate SCTs"自查。
怎么确认 SSL 证书报错已修复?6 种验证方法
浏览器出现小锁,不等于证书问题真的修好了。遇到 ssl证书报错怎么办,要把“信任链、主机名、有效期、协议套件、OCSP、缓存”分开验证;下面 6 种方法从单次握手到自动巡检逐层确认。
- OpenSSL 严格验证:先看退出码,不靠肉眼。据 OpenSSL 文档,
s_client默认在校验失败后仍继续握手,加-verify_return_error才会让失败直接暴露。OpenSSL 1.1.1/3.x 均适用:# -servername 传 SNI;</dev/null 防止交互挂起;-verify_return_error 校验失败即报错 openssl s_client -connect www.example.com:443 -servername www.example.com -verify_return_error </dev/null通过时末尾应为
Verify return code: 0 (ok)。非 0 即未修复,常见值:10 (certificate has expired)、20 (unable to get local issuer certificate)、62 (hostname mismatch)。 - curl 8.5 验证真实 IP 与 TLS 版本。用
--resolve绕过 DNS,适合切流量前预检:# curl 8.5.0:-I 发 HEAD,-v 输出握手细节;2>&1 合并 stderr curl -Ivs https://www.example.com --resolve www.example.com:443:1.2.3.4 2>&1 | grep -E 'SSL certificate verify|subject:|TLSv1.3'应看到
SSL certificate verify ok.、subject: CN=www.example.com和TLSv1.3。若服务器拒绝 HEAD 返回 405,TLS 校验结果仍有效。 - 链与有效期:检查 30 天阈值和链验证。
fullchain.pem第一张必须是站点证书:# 2592000 秒 = 30 天;返回 0 表示 30 天内不过期,1 表示即将过期 openssl x509 -in fullchain.pem -noout -checkend 2592000 echo $? # 用系统根证书验证站点证书,中间证书用 -untrusted 提供 openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted intermediate.pem cert.pem # 期望输出:cert.pem: OKRHEL 系根证书路径为
/etc/pki/tls/certs/ca-bundle.crt。据 RFC 5280,链验证还要检查 Basic Constraints、Key Usage 与有效期。 - 协议与套件扫描:确认旧协议关闭、链完整、OCSP 已装订。
# testssl.sh 3.2+;--fast 跳过部分耗时检查 testssl.sh --fast https://www.example.com # sslyze 6.x;--regular 为常规扫描级别 sslyze --regular www.example.com:443重点看
TLS 1.0 not offered、TLS 1.1 not offered、Certificate chain: complete、OCSP stapling: Yes。据 Mozilla SSL 配置指南,公开站点应只启用 TLS 1.2/1.3。 - 浏览器复核:排除缓存与 HSTS 干扰。Chrome 126 打开 DevTools → Security → View certificate,核对 SAN 是否覆盖域名(RFC 6125 要求主机名匹配)、有效期与颁发者。访问前在
chrome://net-internals/#hsts删除该域名的 HSTS 策略,或用Ctrl+Shift+N无痕窗口,避免旧证书缓存造成“假通过”。 - 自动化巡检:提前 21 天告警。blackbox_exporter 0.25.0 可暴露
probe_ssl_earliest_cert_expiry(Unix 时间戳):# blackbox.yml:https_cert 模块,insecure_skip_verify 默认 false modules: https_cert: prober: http timeout: 5s http: preferred_ip_protocol: ip4 # 默认 ip6,按网络环境调整 tls_config: insecure_skip_verify: false# Prometheus 告警:剩余不足 21 天(86400*21 秒)且探针成功 alert: SSLCertExpiringSoon expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 21 and probe_success == 1 for: 1hZabbix 6.4+ 可用
web.certificate.get[www.example.com,443]取回not_after,再计算剩余天数。
| 验证方法 | 关键命令/工具 | 通过标准 | 主要盲区 |
|---|---|---|---|
| OpenSSL 严格验证 | s_client -verify_return_error |
Verify return code: 0 (ok) |
不检查 OCSP 装订与套件 |
| curl 8.5 | --resolve + grep |
verify ok 且 TLSv1.3 |
只测单 IP、单 SNI |
| 链与有效期 | x509 -checkend、verify |
返回 0;cert.pem: OK |
不验证服务器实际发送链 |
| 协议扫描 | testssl.sh / sslyze | TLS 1.0/1.1 关闭、链完整、OCSP Yes | 扫描器规则版本差异 |
| 浏览器复核 | Chrome 126 DevTools | 无红色警告,SAN/有效期正确 | 缓存/HSTS 可能掩盖问题 |
| 自动巡检 | blackbox_exporter / Zabbix | 剩余天数 > 21 天 | 只测到期,不测主机名与链 |
六项都通过,才算把 ssl证书报错怎么办 从“浏览器看起来正常”推进到可复现、可告警的修复证据。
如何避免下一次 SSL 证书报错?续期、监控与变更管理
证书明明续期成功了,为什么下一次还会报错?
因为”续期任务存在”和”续期任务真的在跑”是两件事。certbot 2.x 通过 systemd timer 触发,而不是传统 crontab,所以装完不看一眼 timer 状态,很容易在半年后才发现它从未启用。据 Let’s Encrypt 文档,certbot 默认在证书剩余 30 天时续期,而 --dry-run 走的是 staging 环境,不消耗生产速率限制,可以放心每月演练一次。
# certbot 2.x(apt/dnf 包安装,systemd 环境)
systemctl list-timers | grep certbot
# 期望输出含:certbot.timer ... 下次触发时间 ...
systemctl is-enabled certbot.timer # 期望 enabled,否则 systemctl enable --now certbot.timer
# 每月执行一次,验证 ACME 挑战链路(DNS/80 端口/防火墙)仍然通
certbot renew --dry-run
# 成功输出:Congratulations, all simulated renewals succeeded
用 acme.sh 的则要看 crontab 里那条带 --cron 的记录(安装时默认写入,分钟数为随机值,续期阈值默认 --days 60),日志落在 ~/.acme.sh/acme.sh.log:
crontab -l | grep -- '--cron'
# 0 43 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null
tail -n 50 ~/.acme.sh/acme.sh.log
grep -iE "error|skip|retry" ~/.acme.sh/acme.sh.log | tail
到期告警设成提前 30 天够不够?
不够,要两级:剩余 30 天进运维群,剩余 7 天升级到值班手机。脚本判断用 openssl x509 -checkend,参数是秒数,返回码 0 表示”尚未到期”,非 0 表示已进入窗口:
#!/usr/bin/env bash
# 退出码 0=正常,2=7 天内过期;适合塞进 cron / Zabbix 用户参数
CERT=/etc/letsencrypt/live/example.com/fullchain.pem
openssl x509 -checkend 604800 -noout -in "$CERT" || {
echo "CRITICAL: $CERT 将在 7 天内过期" >&2; exit 2; }
规模大时别用脚本轮询,交给 blackbox_exporter 统一采集,它暴露的 probe_ssl_earliest_cert_expiry(Unix 时间戳)可直接写告警规则 probe_ssl_earliest_cert_expiry - time() < 86400 * 30。三种方式的分工差异明显:
| 方式 | 检测点 | 能发现的盲区 | 典型代价 |
|---|---|---|---|
| openssl 脚本 + cron | 本机文件 | 文件对但未 reload、边缘节点未同步 | 零依赖,需自己写告警 |
| blackbox_exporter | 外部 TLS 握手 | 本机文件与线上实际下发不一致 | 需 Prometheus 栈 |
| CDN/云负载均衡控制台 | 边缘证书 | 源站证书、内部 mTLS 证书 | 各厂商能力不一 |
换了证书,怎么确认边缘和源站是同一张?
比对 SHA-256 指纹,而不是看有效期——同一天签发的两张证书有效期往往完全相同。把本地文件指纹和线上实际下发的指纹分别取出来逐位对照:
# 本地文件
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -fingerprint -sha256
# 线上实际下发(-servername 不可省,否则可能拿到默认站点证书)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -fingerprint -sha256
两者不一致时,Nginx 往往已经在 error.log 里报了 SSL_CTX_use_PrivateKey_file(...) failed ... key values mismatch——这几乎总是 cert 与 key 不配对,而不是权限问题。
私钥怎么放才不算”裸奔”?
最小权限:chmod 600 privkey.pem,属主为 root 或专用证书账号。Nginx master 进程以 root 启动时读取私钥,worker 以 nginx 用户运行并不需要读权限,所以不要把私钥 chown 给 nginx。私钥绝不进 Git,交给 Vault、云 KMS 或 Ansible Vault 管理。
chown root:root /etc/nginx/ssl/privkey.pem
chmod 600 /etc/nginx/ssl/privkey.pem
ls -l /etc/nginx/ssl/privkey.pem # 期望 -rw------- 1 root root
怎么在日志里留下握手证据?
在 http{} 块里定义带 TLS 变量的 log_format,才能事后统计协议分布、定位老客户端握手失败:
log_format ssl_trace '$remote_addr [$time_local] "$request" $status '
'$ssl_protocol $ssl_cipher $ssl_server_name';
access_log /var/log/nginx/ssl_access.log ssl_trace;
最后是变更管理:每季度按 Mozilla SSL Configuration Generator 复核一次 ssl_protocols/ssl_ciphers(其 “Intermediate” 配置目前仍兼容 TLS 1.2,TLS 1.3 密码套件不受 ssl_ciphers 控制)。同时留意 CA/Browser Forum 已通过的有效期缩短时间表——2026 年起逐步压缩、2029 年降至 47 天,意味着”一年一续”的运维习惯必须提前改成自动化。想系统性地减少 ssl证书报错怎么办 这类救火,重点不在排错速度,而在于把续期、告警、指纹核对固化成可验证的例行检查。
需要修。浏览器允许手动跳过只代表桌面端可临时访问,curl、Java、Android App 和支付回调会直接失败;按证书链、SAN、有效期三项排查,通常 10 分钟内能定位。
两者信任链等价,报错类型也相同;主要差别是 Let's Encrypt 有效期 90 天、必须自动化续期,商业 DV 常见 398 天并提供 SLA 与人工支持。若团队没有定时任务与到期监控,免费证书反而更容易触发 NET::ERR_CERT_DATE_INVALID。
App 使用系统或自带信任库,不一定会像 Chrome 那样通过 AIA 补链。Android 7 以下或未更新信任库的终端可能不信任 ISRG Root X1,服务端只发站点证书也会让 OkHttp 报链不完整;Nginx 改 fullchain.pem 并升级客户端信任库即可。
先执行 openssl s_client -connect 域名:443 -servername 域名 -showcerts 看服务端是否缺中间证书;Nginx 把 ssl_certificate 改成 fullchain.pem 并 reload。临时验证可用 curl –cacert chain.pem,不要用 -k 上线掩盖问题。
*.example.com 覆盖 www.example.com、api.example.com,但不覆盖 a.b.example.com,也不覆盖根域 example.com。需要二级子域时签发 *.b.example.com,或使用多域名 SAN 证书把相关 FQDN 全部列入。
会。CDN 边缘证书与回源证书是两套配置,边缘证书过期或链不完整时源站看起来完全正常;用 curl –resolve 把域名指向源站 IP 对比,再检查 CDN 控制台上传的证书是否包含中间证书、是否已过期。
只能对受控客户端消除:把自签根证书导入系统或 Java cacerts 信任库。面向公众的网站无法要求所有用户安装根证书,应改用公共 CA 签发的 DV/OV 证书;内网测试可用 mkcert 生成本地信任链。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。