跳到主要内容
错误排查

SSL证书过期怎么配置?fullchain 替换、reload 生效与 6 类报错排查

SSL证书过期怎么配置 — SSL证书过期怎么配置?fullchain 替换、reload 生效与 6 类报错排查
核心结论

SSL证书过期后要配置的是“新证书 + 完整中间链 + 匹配私钥”的加载路径,而不是改有效期:把 fullchain(叶子在前、中间在后)写入 ssl_certificate,nginx -t 通过后 reload,30 秒内用 openssl s_client -connect 域名:443 -servername 域名 验证 notAfter 已更新且 Verify return code 为 0。 Nginx 1.24/1.26 用 systemctl reload nginx 即可生效,但旧 worker 会继续用旧证书服务存量长连接;设置 worker_shutdown_timeout 30s 可缩短新旧证书并存窗口。 Apache 2.4.8+ 可把中间链并入 SSLCertificateFile,Tomcat 9 改 PKCS12 keystore 后必须重启 JVM,IIS 10 要用 netsh http show sslcert 核对 Certificate Hash 与站点绑定一致。 证书有效期上限受 CA/Browser Forum 约束:公开 TLS 证书自 2020-09-01 起不超过 398 天,Let's Encrypt 默认 90 天;建议在到期前 30/14/7/1 天分级告警,blackbox_exporter 0.25.0 可用 probe_ssl_earliest_cert_expiry 指标。 私钥不匹配会直接报 SSL: error:0B080074 ... key values mismatch,先用 openssl x509 -noout -pubkey 与 openssl pkey -pubout 比对公钥,再 reload。

SSL证书过期怎么配置:先分清“没续期”还是“没加载

Q:证书明明已经续期,为什么浏览器还是提示过期?

先别急着改配置,第一步是确认服务端此刻到底在发哪张证书——很多“过期”其实是“没加载”,服务端发出来的还是旧文件。

# 1) 看服务端真实发出的证书(-servername 强制带 SNI,避免拿到默认站点证书)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -dates -issuer -subject -fingerprint -sha256
# 输出示例:
# notBefore=Jun  1 00:00:00 2025 GMT
# notAfter=Aug 30 23:59:59 2025 GMT
# issuer=C=US, O=Let's Encrypt, CN=R11

# 2) 对比磁盘文件指纹,判断是“文件没换”还是“换了没生效”
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -fingerprint -sha256

# 3) 检查链是否完整:正常 2~3 张(叶子+中间),只有 1 张说明漏发中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -c "BEGIN CERTIFICATE"

# 4) 操作前先留回滚点
cp -a /etc/nginx/ssl /etc/nginx/ssl.bak.$(date +%F)

若第 1 步的 notAfter 已是新日期,说明续期与替换都成功,问题在别处;若仍是旧日期而第 2 步指纹已是新的,就是典型的“换了文件但没 reload”——Nginx 只在启动和 nginx -s reload 时读取 ssl_certificate,改文件本身不会触发重载(OpenSSL 1.1.1+、Nginx 1.19 之后行为一致)。

根因 典型现象 确认方式 处置
CA 侧未续期 notAfter 已过,磁盘文件也是旧的 acme.sh --list / certbot certificates 看到期时间 修复 cron 或 systemd timer,手动 --renew 一次
已换文件未 reload 磁盘指纹新、线上指纹旧 对比上面第 1、2 步的 SHA-256 nginx -t && nginx -s reload
加载了错误文件 只配叶子证书导致 Android/Java 报链错误;或私钥与证书不匹配 -showcerts 计数为 1;两文件 modulus 不一致 ssl_certificate 指向 fullchain.pem

私钥与证书是否配对,用一条命令即可判定,两个 MD5 必须相同:

openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -modulus | openssl md5
openssl rsa  -in /etc/nginx/ssl/privkey.pem   -noout -modulus | openssl md5
# 不一致时 Nginx 报:SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:
# x509 certificate routines:X509_check_private_key:key values mismatch)

Q:服务端日期正常,为什么 Java 客户端还是报 PKIX path building failed?

这要区分“服务端证书过期”和“客户端信任链过期”。前者看服务端 notAfter;后者服务端日期完全正常,但客户端 cacerts 里的根证书已失效——最典型的是 DST Root CA X3 于 2021-09-30 到期,导致老版本 Android(7.1 及以下)和未更新的 JDK 访问 Let’s Encrypt 站点时报 PKIX path building failed: unable to find valid certification path。另一常见诱因是服务端只发叶子证书、未附中间链,浏览器能靠 AIA 补链,Java 不会。据 RFC 5280 第 6.1 节,证书路径验证必须检查有效期,过期证书应被判定为不可用。

有效期规则:据 CA/Browser Forum Ballot SC-31,2020-09-01 起公开 TLS 证书最长有效期 398 天;据 Let’s Encrypt 文档,其证书有效期 90 天,官方建议在剩余 30 天左右续期。后续 SC-081 计划 2026-03-15 起缩短至 200 天,2027 年起 100 天,2029 年起 47 天——配置续期任务时应假设每年至少换 2 到 4 次,而不是“配一次管一年”。

不要用绕过手段:curl -k、Java 里的 trustAll、Nginx 的 proxy_ssl_verify off 只是把校验关掉,中间人攻击将完全不可见,且线上故障会从“报错”退化为“静默错误”。正确做法是修链、修续期任务、修 reload 流程,SSL证书过期怎么配置的本质是流程问题而非单条命令。

SSL证书过期后的完整实操步骤:8 步从备份到灰度生效

证书过期后最怕的不是”换文件”,而是换错文件、换完没生效、生效了没验证。下面这套 8 步流程在 Nginx / Apache / HAProxy 上通用,核心思路是:先备份、先自检、先单节点灰度,再批量 reload。全程不需要停服。

步骤 1–2:确认域名与 SAN,再核对新证书有效期。先想清楚这张证书要覆盖哪些名字——裸域 example.com 和 www.example.com 是两个不同的 SAN 条目,只签了其中一个,另一个浏览器照样报错。下载证书包后(Let’s Encrypt 用 certbot 时产物在 /etc/letsencrypt/live/example.com/,据 Let’s Encrypt 文档,该目录下 fullchain.pem 已经是”叶子 + 中间”的成品,无需自己拼),先用 OpenSSL 把事实核一遍:

# 核对主体、签发者、有效期、SAN 覆盖范围(OpenSSL 1.1.1 / 3.x 通用)
openssl x509 -in cert.pem -noout -subject -issuer -dates -ext subjectAltName
# 输出示例:
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R3
# notBefore=Jun  1 00:00:00 2025 GMT
# notAfter=Aug 30 23:59:59 2025 GMT
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com

重点看 notBefore:如果新证书的生效时间比服务器当前时间晚(时区偏差或签发队列延迟),reload 后浏览器会报 NET::ERR_CERT_DATE_INVALID,看起来”像没过期却报错”。

步骤 3:拼 fullchain,顺序错了必挂。只有当你拿到的是分离的 .crt + intermediate.crt 时才需要拼:

# 顺序:叶子证书在前,中间证书在后;根证书绝对不要放进来
cat example.com.crt intermediate.crt > fullchain.pem

# 验证链完整性,期望输出 fullchain.pem: OK
openssl verify -untrusted intermediate.crt fullchain.pem

把根证书塞进 fullchain 会让部分客户端(尤其是 Android 旧版本和 Java 客户端)多收一个冗余证书,握手包变大且可能触发校验失败;而漏掉中间证书,桌面浏览器因缓存可能正常,手机端却报 unable to get local issuer certificate——这是最常见的”一半人能打开”故障。

步骤 4:私钥必须与证书匹配。两种算法校验方式不同,别混用:

密钥类型 证书侧命令 私钥侧命令 期望结果
RSA(2048/4096) openssl x509 -in fullchain.pem -noout -modulus | openssl md5 openssl rsa -in privkey.pem -noout -modulus | openssl md5 两行 MD5 完全相同
ECDSA(P-256) openssl x509 -in fullchain.pem -noout -pubkey openssl pkey -in privkey.pem -pubout 两段 PEM 公钥逐字节一致

不匹配时 Nginx 启动直接失败,报 SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。

步骤 5:权限与路径,SELinux 是最隐蔽的坑。私钥必须 chmod 600、属主 root:root(或让 Nginx worker 用户可读);在 CentOS / RHEL 开启 SELinux 的环境,文件从 /tmp 拷过来会继承错误的上下文,Nginx 报 13: Permission denied 而不是配置错误,极易误判:

chmod 600 /etc/nginx/ssl/privkey.pem
chown root:root /etc/nginx/ssl/privkey.pem
# SELinux 环境二选一
chcon -t httpd_config_t /etc/nginx/ssl/privkey.pem
restorecon -Rv /etc/nginx/ssl        # 更推荐,按策略恢复

步骤 6:先语法检查,再 reload,别 restart。

nginx -t                                  # 期望 syntax is ok / test is successful
apachectl configtest                      # Apache 2.4:Syntax OK
haproxy -c -f /etc/haproxy/haproxy.cfg    # 期望 Configuration file is valid
systemctl reload nginx                    # reload 不中断连接,优于 restart

例外是 JVM 与 Windows 栈:Tomcat 用 JKS/PKCS12 keystore,IIS 绑定在 HTTP.sys,两者改证书后必须重启对应服务或重新绑定端口,reload 无效——这也是很多人”reload 完还是旧证书”的原因。

步骤 7–8:单节点灰度 + 可回滚。先在 1 台节点替换,用 --resolve 绕过 DNS 直连该节点验证,确认无误再批量;回滚就是把备份目录换回并 reload,旧证书建议保留至少 7 天(覆盖一个完整的发布周期):

# 灰度验证:强制解析到指定节点,看实际协商到的证书
curl --resolve example.com:443:10.0.0.11 -vI https://example.com 2>&1 | grep -E "subject|issuer|expire"

# 备份与回滚
cp -a /etc/nginx/ssl /etc/nginx/ssl.bak.$(date +%F)
# 回滚时:
# rm -rf /etc/nginx/ssl && mv /etc/nginx/ssl.bak.2025-06-01 /etc/nginx/ssl && nginx -t && systemctl reload nginx

最后提醒一句:SSL 证书过期怎么配置这件事的真正成本不在替换本身,而在”忘记替换”——据 Let’s Encrypt 文档,其证书有效期 90 天,官方建议用 certbot renew --dry-run 演练自动续期并把 reload 钩子写进 /etc/letsencrypt/renewal-hooks/deploy/,否则半年后同样的 8 步要再走一遍。至于 reload 后仍报错的 6 类典型故障,见下一节排查清单。

Nginx / Apache / Tomcat / IIS 的配置示例与关键参数

证书文件换好了,但不同中间件“把证书喂给谁、怎么让它生效”完全是两套逻辑。下面按你实际会遇到的问法逐条给出可直接复制的片段,版本号都标注清楚——参数名在不同版本之间会变,抄错版本比抄错路径更常见。

Nginx 1.24/1.26 的 server 块怎么写?下面这段按 Mozilla Server Side TLS 5.7 的 intermediate 档取值,兼容 1.24.0 与 1.26.1:

server {
    listen 443 ssl;
    http2 on;                       # 1.25.1+ 写法;1.24.x 请改回 listen 443 ssl http2;
    server_name www.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 叶子证书 + 中间链,顺序不能反
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;
    # 1.11.0+ 支持同一 server 写多组,实现 RSA + ECDSA 双证书自动协商
    # ssl_certificate     /etc/nginx/ssl/ecdsa-fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/ecdsa-privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3;                      # intermediate 档不再含 TLSv1.1
    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;                      # TLS1.3 时代交给客户端选

    ssl_session_cache   shared:SSL:10m;                 # 10MB ≈ 4 万条会话
    ssl_session_timeout 1d;
    ssl_session_tickets off;

    ssl_stapling on;                                    # OCSP 装订,减少客户端回源
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;   # 只放中间链,用于校验装订响应
    resolver 223.5.5.5 valid=300s;
}
nginx -t && systemctl reload nginx   # reload 发 HUP,旧 worker 处理完存量连接才退出,不断连

两个容易踩的坑:ssl_buffer_size 默认 16k,小文件场景可调到 4k 降 TTFB,但它和证书过期毫无关系,排查续期问题时不要顺手改它;私钥与证书不匹配时 nginx -t 会直接报 SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。

Apache httpd 2.4.59 怎么配?据 Apache 2.4 文档,自 2.4.8 起 SSLCertificateChainFile 已废弃,中间链应直接拼进 SSLCertificateFile,再配它反而可能打乱链顺序导致部分安卓端报“证书链不完整”:

SSLEngine on
SSLCertificateFile      /etc/httpd/ssl/fullchain.pem   # 2.4.8+ 允许包含中间链
SSLCertificateKeyFile   /etc/httpd/ssl/privkey.pem
# SSLCertificateChainFile 已废弃,不要再写
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
SSLSessionCache         shmcb:/run/httpd/ssl_scache(512000)   # 参数单位是字节,不是条数
SSLSessionCacheTimeout  300
httpd -t && systemctl reload httpd

Tomcat 9.0.90 为什么必须重启?因为 JSSE 在 Connector 初始化时就把 keystore 读进内存,reload 不会重读。先用 OpenSSL 把 PEM 转成 PKCS12:

openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem 
  -out keystore.p12 -name tomcat -CAfile chain.pem -caname root
# -name 必须与 Connector 的 keyAlias 一致
keytool -list -v -keystore keystore.p12   # 期望看到 Certificate chain length: 3(叶子+中间+根)
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" maxThreads="200">
  <SSLHostConfig>
    <Certificate certificateKeystoreFile="/opt/tomcat/conf/keystore.p12"
                 certificateKeystoreType="PKCS12"
                 certificateKeystorePassword="YourPassword"
                 type="RSA"/>
    <SSLHostConfig protocols="TLSv1.2,TLSv1.3"/>
  </SSLHostConfig>
</Connector>

IIS 10 / Windows Server 2019 怎么换?导入后用 netsh 核对指纹,这一步能省掉 80% 的“换了证书浏览器还是旧证书”问题:

Import-PfxCertificate -FilePath C:/ssl/site.pfx -CertStoreLocation Cert:/LocalMachine/My
# 站点绑定中勾选 SNI,多站点共用 443 时必须勾
netsh http show sslcert hostnameport=www.example.com:443   # 核对 Certificate Hash 是否为新证书
netsh http update sslcert hostnameport=www.example.com:443 certhash=<新指纹> appid=<原appid>

据 Microsoft netsh http 文档,HTTP.sys 会缓存绑定信息,改完绑定后无需 iisreset,但缓存必须刷新才会加载新证书。

HAProxy 2.8/3.0 的 crt 文件有什么讲究?crt 指向的单个 PEM 必须依次包含叶子证书、私钥、中间链,缺一段都会在握手阶段报 SSL handshake failure:

frontend https_in
    bind *:443 ssl crt /etc/haproxy/certs/example.pem alpn h2,http/1.1
    default_backend app

# 校验通过再 reload,-c 只检查配置不启停进程
haproxy -c -f /etc/haproxy/haproxy.cfg && systemctl reload haproxy
中间件 生效命令 是否断连 是否重读证书
Nginx 1.24+ systemctl reload nginx 否,旧 worker 优雅退出 是
Apache 2.4.59 systemctl reload httpd 否,graceful restart 是
Tomcat 9.0.90 systemctl restart tomcat 是 否,reload 无效
IIS 10 netsh http update sslcert 否 需刷新绑定缓存
HAProxy 2.8/3.0 systemctl reload haproxy 否,无缝切换 是

配置层的动作只解决“新证书有没有被加载”,若浏览器仍报 NET::ERR_CERT_DATE_INVALID 或 SSL_ERROR_NO_CYPHER_OVERLAP,问题就落在证书链顺序、系统时间或协议套件交集上,属于下一节的排查范围。

不同部署形态的证书替换方式对比表

同样是换一张证书,为什么有人 reload 就生效,有人必须重启整个 JVM?根因在于进程读取证书的时机不同:Nginx、Apache、HAProxy 在收到 reload 信号后重新解析配置并重新打开证书文件(旧 worker 处理完存量连接后退出,实现零中断);Tomcat 在 Connector 初始化时把 keystore 载入内存,IIS 则由 Windows HTTP.sys 从证书存储中读取绑定时的指纹,两者都不会因文件变化而自动重载。下表是主流部署形态的替换动作对照,可据此判断你的变更窗口该申请几分钟还是半小时。

部署形态 证书文件形态 生效动作 是否需重启 典型耗时 关键检查
Nginx 1.24 / 1.26 fullchain.pem + privkey.pem 分离 systemctl reload nginx 否(reload) 5–30 秒 nginx -t;openssl s_client 看 notAfter
Apache 2.4.59 fullchain.pem 可合并进 SSLCertificateFile systemctl reload httpd 否 5–30 秒 configtest;不再配置 SSLCertificateChainFile
Tomcat 9.0.90 PKCS12 keystore(.p12) 重启 JVM 是 30–120 秒 keytool -list 链长度=3;Connector 端口
IIS 10 PFX 导入 LocalMachine/My 重新绑定或 netsh 更新 否(应用池回收) 10–60 秒 netsh http show sslcert 的 Hash
HAProxy 2.8 / 云 LB / CDN 单 PEM(cert+key+chain)或控制台上传 reload 或 API 下发 HAProxy 否、云 LB 否 10 秒–5 分钟 回源协议、CNAME、证书与域名匹配

Nginx 侧最常见的坑是只放了叶子证书而漏掉中间证书——桌面浏览器靠 AIA 抓取能自愈,Android 与部分 Java 客户端则直接握手失败。据 Let’s Encrypt 文档,fullchain.pem 才是应指向 ssl_certificate 的文件:

# /etc/nginx/conf.d/site.conf
ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 叶子+中间链,勿用 cert.pem
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;    # 仅私钥,建议 chmod 600
# 先验语法再平滑重载;失败时 nginx -t 会直接给出证书与私钥不匹配的报错
nginx -t && systemctl reload nginx
# 核对线上实际下发的证书到期时间与签发者
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -dates -issuer

Apache 从 2.4.8 起 SSLCertificateChainFile 已废弃,2.4.59 上继续配置只会得到 AH02559: The SSLCertificateChainFile directive is deprecated 警告,正确做法是把整条链拼进 SSLCertificateFile。Tomcat 则必须重新生成 keystore 并重启:

# Tomcat 9.0.90:导出 PKCS12 并确认链长度为 3(叶子+2 张中间证书)
keytool -list -v -keystore /opt/tomcat/conf/keystore.p12 -storetype PKCS12 | grep -E "Certificate[|Valid"
systemctl restart tomcat   # 改 Connector 的 keystoreFile 后必须重启 JVM

# IIS 10:绑定未刷新时的典型现象是浏览器仍返回旧证书,用 Hash 比对
netsh http show sslcert hostnameport=example.com:443

若 nginx -t 报 SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),说明证书与私钥不是同一对,先 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 比对再 reload。云 LB / CDN 形态还要额外确认回源段是否同样换证,否则会出现「边缘新证书、回源旧证书」的半更新状态,这也是 SSL证书过期怎么配置 时最容易被忽略的一环。

常见报错与排查:从 key values mismatch 到 PKIX path building failed

证书替换后仍报错,90% 不是”证书没换”,而是换错文件、没生效、或链不完整。先按报错文案定位层级,再对症下药——下表把六类高频报错按”出错层 → 首条诊断命令 → 根因”对齐,后面逐条给完整命令序列。

报错文案(关键片段) 出错层 首条诊断命令 最常见根因
key values mismatch 私钥/证书配对 openssl x509 -noout -pubkey fullchain 与 privkey 不是同一次签发
curl: (60) certificate has expired 服务端实际下发的证书 date -u + s_client -dates 未 reload / 多节点漏更 / CDN 未刷新
ERR_CERT_COMMON_NAME_INVALID 域名覆盖(SAN) x509 -ext subjectAltName 通配符层级不够、漏填域名
PKIX path building failed 中间链 / 客户端信任库 keytool -printcert -sslserver 只发了叶子证书,缺中间 CA
AH02217 ssl_stapling_init_cert OCSP Stapling 前置条件 apachectl configtest 开了 Stapling 但证书文件不含签发者链
Keystore was tampered with PKCS12 口令 keytool -list -storetype PKCS12 keystorePass 与 -passout 不一致

为什么 nginx 启动就报 key values mismatch?因为 OpenSSL 在加载私钥时会调用 X509_check_private_key 校验模数/公钥是否配对,不配对直接 [emerg] 退出。别猜,直接比对公钥指纹(OpenSSL 1.1.1 / 3.x 通用):

# 从证书链取叶子证书的公钥并算摘要
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
# 从私钥导出公钥并算摘要,两个 md5 必须完全一致
openssl pkey -in privkey.pem -pubout | openssl md5

# 仅 RSA 证书可用的传统做法(EC 密钥无 modulus,会报错)
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in privkey.pem | openssl md5

如果 s_client 报 ee key too small,那是另一回事:OpenSSL 3.0 默认安全级别为 SECLEVEL=2(Debian/Ubuntu 在 openssl.cnf 里以 CipherString = DEFAULT@SECLEVEL=2 固化),要求 RSA ≥ 2048 位、SHA-1 签名被拒。据 OpenSSL 官方文档,级别 2 对应 112 位安全强度。此时唯一正解是重新签发 2048/3072 位证书,而不是下调 SECLEVEL。

curl 报证书过期,但证书明明是新换的?按”时间 → 实际下发 → 生效范围”三步走:

# 1. 服务器时钟漂移会让新证书"看起来已过期"
date -u

# 2. 看服务端真实下发的证书有效期(-servername 对 SNI 多站点必须加)
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -dates -subject

# 3. 若日期仍旧:确认配置指向新文件并热加载
nginx -t && systemctl reload nginx      # reload 起新 worker 接管,restart 会断连
# Apache: apachectl configtest && systemctl reload httpd

日期没变,通常不是配置问题而是覆盖范围问题:负载均衡后端多节点只更了一台;或前面挂着 CDN,回源证书更新了但边缘节点仍在用缓存证书,需要在 CDN 控制台重新上传/刷新。据 Let’s Encrypt 文档,其证书有效期 90 天、推荐在剩余 30 天时续期,续期后同样需要一次 reload 才能生效。

浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN 怎么查?现代浏览器早已不看 CN 字段,只认 SAN。据 RFC 6125(及被其取代的 RFC 2818 实践),证书 SAN 必须匹配访问域名;且通配符 *.example.com 只覆盖一级子域,a.b.example.com 不匹配。

# 查看 SAN 列表,确认目标域名逐条在列
openssl x509 -in fullchain.pem -noout -ext subjectAltName
# 输出示例:DNS:example.com, DNS:*.example.com
# 再核对线上实际下发的证书(防止 nginx 默认 server 兜底到别的站点)
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -ext subjectAltName

Java 客户端 PKIX path building failed 是谁的锅?多数是服务端没发中间证书。Java 不会像浏览器那样自动补链,据 Oracle JSSE 参考指南,它要求服务端提供完整链且根 CA 在 cacerts 中。

# 数一下服务端发了几张证书:正常 2~3 张(叶子 + 中间,可含根)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c 'BEGIN CERTIFICATE'

# 从 Java 视角看链(JDK 8+ 均支持)
keytool -printcert -sslserver example.com:443

# 若确认服务端缺链:nginx 的 ssl_certificate 必须指向 fullchain(叶子+中间),不是 cert.pem
# 若服务端没问题、是自签/私有 CA:把 CA 导入客户端信任库
keytool -importcert -alias myca -file ca.crt 
  -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit

Apache 报 AH02217: ssl_stapling_init_cert: can’t retrieve issuer certificate!说明 SSLUseStapling on 已开启,但 SSLCertificateFile 指向的文件里没有签发者证书,Apache 无法构造 OCSP 请求。Apache 2.4.8 起 SSLCertificateChainFile 已废弃,正确做法是把 fullchain 直接写进 SSLCertificateFile:

# 推荐写法(Apache 2.4.8+)
SSLCertificateFile      /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile   /etc/letsencrypt/live/example.com/privkey.pem
SSLUseStapling          on
SSLStaplingCache        "shmcb:logs/ssl_stapling(32768)"

apachectl configtest && systemctl reload httpd

Tomcat 启动即抛 Keystore was tampered with, or password was incorrect 怎么办?PKCS12 只校验口令,口令错就是这个文案(Java 9 起默认 keystore 类型已改为 PKCS12)。先用 keytool 验证,再回头对 server.xml:

# 用你以为是正确的口令试开,能列出别名说明口令无误
keytool -list -v -keystore keystore.p12 -storetype PKCS12 -storepass 你的口令

# 生成时指定的 -passout 必须与 Connector 的 keystorePass 完全一致
openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem 
  -certfile chain.pem -out keystore.p12 -name tomcat -passout pass:你的口令
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true">
  <SSLHostConfig>
    <Certificate certificateKeystoreFile="conf/keystore.p12"
                 certificateKeystoreType="PKCS12"
                 certificateKeystorePassword="你的口令" />
  </SSLHostConfig>
</Connector>

排查顺序建议固定为:文件配对 → 链完整 → 域名覆盖 → 时间与生效范围 → 客户端信任库。前四项都可在服务器上用 OpenSSL 一条命令证伪,剩下的才是应用层配置问题;这也是把 SSL 证书过期怎么配置这件事做对之后,仍然需要留一份”报错对照表”的原因——证书换对了,配置与生效链路仍可能各自出错。

验证 SSL 证书过期配置是否生效的 6 种方法

改完 fullchain.pem 并 nginx -s reload 之后,怎么确认新证书真的生效?浏览器绿锁不够:Nginx 的 reload 是平滑重载,旧 worker 会继续用旧证书服务存量长连接;CDN 回源、多台后端、Java 客户端的 truststore 缓存,都可能让你在一部分节点上仍然看到过期的旧链。下面 6 种方法从握手层到应用层逐级递进,建议全部跑过一遍再算完事。

1)服务端握手验证:直接问服务器“你现在拿的是哪张证书”

# 取服务端实际下发的叶子证书,核对有效期与指纹
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1 
  | openssl x509 -noout -subject -issuer -dates -fingerprint -sha256
# 期望:notAfter 为新到期日;fingerprint 与本地 fullchain 第一段完全一致
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -fingerprint -sha256
# 同时确认链完整(缺中间证书会报 unable to get local issuer certificate)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 | grep 'Verify return code'
# 期望:Verify return code: 0 (ok)

注意 -servername 必须写,否则 SNI 未命中会拿到默认站点证书,这是“明明换了却还是旧证书”的头号误判。OpenSSL 3.x 的 s_client 默认不再自动加载系统 CA 之外的链,验证码为 0 才说明服务端把中间证书也发全了。

2)指定节点绕过 DNS/CDN:验证每台后端都换过证书

# 单节点:绕过 DNS,直连 IP,看证书校验结果与到期时间
curl -vI https://example.com --resolve example.com:443:10.0.0.12 2>&1 
  | grep -E 'SSL certificate verify|expire date|subject:'
# 多节点批量:逐个 IP 验证,任一节点日期仍旧即为漏改
for ip in 10.0.0.11 10.0.0.12 10.0.0.13; do
  echo "== $ip"
  curl -svI https://example.com --resolve example.com:443:$ip -o /dev/null 2>&1 
    | grep -E 'SSL certificate verify|expire date'
done

期望输出 SSL certificate verify ok 且 expire date 为新日期。若某节点仍返回旧日期,说明该机器的 fullchain 没替换或 reload 未执行——据 Let’s Encrypt 文档,证书有效期已缩短至 90 天(后续将引入 6 天短周期),漏改一台的成本会越来越高。

3)协议与套件验证:确认旧协议确实被关掉

# TLS 1.1 应握手失败(若已在配置中禁用)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null 2>&1 | grep -E 'Protocol|alert|no protocols'
# 典型失败输出:alert protocol version / no protocols available
# TLS 1.3 应成功
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null 2>&1 | grep 'Protocol'
# 评级与套件枚举
nmap --script ssl-enum-ciphers -p 443 example.com
sslyze --regular example.com

Nginx 默认值 ssl_protocols TLSv1 TLSv1.1 TLSv1.2(1.19.4 之前)早已不满足 Mozilla SSL Configuration Generator 的 intermediate 建议;现代配置应为 ssl_protocols TLSv1.2 TLSv1.3;。

4)OCSP stapling 验证:让客户端不必自己回源查吊销状态

# 期望输出 OCSP Response Status: successful (0x0)
echo | openssl s_client -connect example.com:443 -servername example.com -status 2>/dev/null 
  | grep -A2 'OCSP Response Status'
# 若显示 no response sent,说明 stapling 未开启或未取到响应
# Nginx 侧必须三项齐备,缺 ssl_trusted_certificate 会导致取不到 OCSP 响应
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;   # 指向中间 CA,不能只给叶子证书

按 RFC 6960,OCSP 响应由中间 CA 签发,所以信任锚必须是中间证书链而非叶子证书;这也是换 fullchain 后 stapling 突然报 ssl_stapling ignored, issuer certificate not found 的原因。

5)应用层日志验证:看真实流量走的是哪个协议

# Nginx:定义 SSL 专用日志格式并启用
log_format ssl '$remote_addr $ssl_protocol $ssl_cipher $ssl_server_name $ssl_early_data';
access_log /var/log/nginx/ssl_access.log ssl;
# 观察新连接是否落在 TLSv1.3
tail -f /var/log/nginx/ssl_access.log
# Apache:LogFormat 中 SSL 变量需带 x 后缀
LogFormat "%h %{SSL_PROTOCOL}x %{SSL_CIPHER}x %t "%r"" ssl_log
CustomLog logs/ssl_access.log ssl_log
# Java 客户端排障:看是否命中新证书
java -Djavax.net.debug=ssl:handshake -jar app.jar 2>&1 | grep -E 'Found trusted certificate|Protocol'

6)第三方与浏览器视角:最后一道外部确认

# Java 视角的证书链(绕过浏览器缓存,常用于对接方排障)
keytool -printcert -sslserver example.com:443 | head -20

Chrome DevTools 的 Security 面板可看 “Valid for” 日期;SSL Labs 跑出 A/A+ 需要 HSTS 头 Strict-Transport-Security: max-age=31536000; includeSubDomains,但 preload 不可逆,提交前务必确认所有子域都已全站 HTTPS。

方法 核心命令 能发现什么 耗时
握手验证 openssl s_client -showcerts 服务端实际下发的证书与链完整性 <1s
指定节点 curl --resolve + for 循环 多后端/绕过 CDN 的漏改节点 按节点数
协议套件 -tls1_1 / nmap ssl-enum-ciphers 旧协议是否真正关闭 5–30s
OCSP stapling s_client -status 吊销状态是否随握手下发 <2s
应用日志 Nginx/Apache SSL 日志格式 真实流量协议分布、长连接残留 持续
第三方 SSL Labs / DevTools / keytool 外部视角评级与链信任 1–2min

如果第 1 步的 fingerprint 与本地 fullchain 不一致,先别怀疑证书本身:检查 nginx -T | grep ssl_certificate 实际加载的路径、是否被 include 的其他 server 块覆盖,以及 reload 是否真的成功(systemctl status nginx 看是否仅 graceful 而非 restart)。这套排查顺序同样适用于“SSL证书过期怎么配置”之后的回归验证——改完不等于生效,验证闭环才算配置完成。

过期前的监控与告警配置:30/14/7/1 天分级

为什么不能盯本地证书文件的 mtime?因为过期故障几乎都发生在”链路”上而不是”文件”上:CDN、四层负载均衡、K8s Ingress 各自持有一份副本,源站 fullchain.pem 换了、systemctl reload nginx 也跑了,边缘节点仍在用旧证书。所以监控必须打在实际握手返回的证书上——这也是排查 fullchain 替换与 reload 生效 的前置条件。

blackbox_exporter 怎么配 30/14/7/1 天分级?blackbox_exporter 0.25.0 的 http prober 在 TLS 握手成功后会输出 probe_ssl_earliest_cert_expiry,单位是秒级 Unix 时间戳(不是剩余天数),因此告警表达式必须减去 time():

# blackbox.yml —— 适用 blackbox_exporter 0.25.0
modules:
  https_cert:
    prober: http
    timeout: 10s
    http:
      method: GET
      preferred_ip_protocol: ip4
      valid_status_codes: [200, 204, 301, 302, 403]  # 403 也算握手成功,避免站点改权限后漏报

# prometheus rules —— 关键:必须用 and 过滤掉探测失败的样本
groups:
- name: tls-expiry
  rules:
  - alert: SSLCertExpiry30d
    expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 30 and probe_success == 1
    for: 30m
    labels: {severity: info}
  - alert: SSLCertExpiry14d
    expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 14 and probe_success == 1
    for: 10m
    labels: {severity: warning}
  - alert: SSLCertExpiry7d
    expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 7 and probe_success == 1
    for: 10m
    labels: {severity: critical}
  - alert: SSLCertExpiry1d
    expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 1 and probe_success == 1
    labels: {severity: page}   # 走 Alertmanager 电话/短信路由
剩余天数 阈值(秒) 通知通道 期望动作
30 天 86400 × 30 邮件 / IM 频道 确认续期任务已入调度,检查 --deploy-hook 是否绑定
14 天 86400 × 14 IM + 值班群 核对续期日志,确认 CDN/LB 副本同步
7 天 86400 × 7 电话 / 短信 人工执行 certbot renew --force-renewal
1 天 86400 × 1 电话 + 短信重复呼叫 紧急替换 fullchain 并 reload,事后复盘

没有 Prometheus,怎么用 shell 一把梭?下面的脚本读 domains.txt(一行一个域名),低于阈值 exit 1,可直接挂到 Zabbix 的 UserParameter 或 cron:

#!/usr/bin/env bash
# 适用:OpenSSL 1.1.1 / 3.x + GNU coreutils;macOS 需用 gdate
set -u
THRESHOLD=${THRESHOLD:-30}; fail=0
while read -r host; do
  [ -z "$host" ] && continue
  end=$(echo | openssl s_client -connect "${host}:443" -servername "$host" 2>/dev/null 
        | openssl x509 -noout -enddate | cut -d= -f2)
  if [ -z "$end" ]; then echo "$host HANDSHAKE_FAIL"; fail=1; continue; fi
  left=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
  echo "$host $left"
  [ "$left" -lt "$THRESHOLD" ] && fail=1
done < domains.txt
exit $fail

不想写脚本就用 Zabbix 6.4:agent 2 内置监控项 web.certificate.get[example.com,443],官方模板 Website certificate by Zabbix agent 2 已预置过期天数触发器,注意它默认校验证书链(ssl_verify 参数默认开启),自签环境需显式关闭。

续期成功了为什么还报过期?因为多数人只配了续期、没配 reload。certbot 2.10 用 --deploy-hook(仅续期成功时执行),acme.sh 3.0.7 用 --reloadcmd:

certbot renew --deploy-hook 'systemctl reload nginx' --dry-run   # 先演练
acme.sh --issue -d example.com -w /var/www/acme --reloadcmd 'systemctl reload nginx'

验证”文件新、握手也新”只需比对两个指纹,任一为空或不一致即说明 reload 未生效或命中了旧路径:

openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -fingerprint -sha256
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -fingerprint -sha256

握手失败时你会看到 verify error:num=10:certificate has expired,这类报错应直接进入紧急通道,而不是等 30 天档的邮件。

阈值该定多少天?据 CA/Browser Forum Baseline Requirements,398 天是上限而非目标;据 Let’s Encrypt 文档,90 天证书建议在剩余约 30 天时续期(并已支持 ARI 自动建议续期窗口);付费 DV 一年期证书同样应在到期前 30 天完成替换——把 30 天档设成”开始动作”而非”开始关注”,才能避开春节、国庆这类无人值守窗口。至于 1 天档为什么必须打电话:因为此时留给 6 类报错排查 的时间已经不够走工单流程了。

多域名、通配符与 CDN 场景下配置过期证书的差异

同一张多域名 SAN 证书,能不能让多个 server 块共用?能——只要每个 server_name 都真实出现在 SAN 列表里。Nginx 允许多个 server 指向同一个 fullchain 文件,过期替换时只改一处、执行一次 nginx -t && nginx -s reload 即可。风险在于“证书换了但域名没覆盖”:握手阶段成功,应用层才报错,典型输出为 curl: (60) SSL: no alternative certificate subject name matches target host name 'api.example.com'。按 RFC 6125 的规则,通配符 *.example.com 只匹配一级子域,a.b.example.com 必须单独写 SAN 或另发 *.b.example.com;替换后不要凭印象判断,直接核对:

# OpenSSL 1.1.1+ 才有 -ext;1.0.2 请用 openssl x509 -noout -text | grep -A1 "Subject Alternative Name"
openssl x509 -noout -ext subjectAltName -in /etc/nginx/ssl/fullchain.pem
# 期望输出:X509v3 Subject Alternative Name:
#             DNS:*.example.com, DNS:example.com

# SNI 多证书场景:同一 IP 上 a/b 两个 server 各自 ssl_certificate,必须分别验证
openssl s_client -connect 203.0.113.10:443 -servername a.example.com /dev/null 
  | openssl x509 -noout -subject -dates
openssl s_client -connect 203.0.113.10:443 -servername b.example.com /dev/null 
  | openssl x509 -noout -subject -dates

SNI 由 RFC 6066 定义;不带 SNI 的旧客户端(老版本 Java、部分监控探针、直接用 IP 访问)会拿到 default_server 的证书,于是“我明明换了证书却还报过期”多半是命中了默认 server 的旧文件。

场景 证书实际生效位置 最易漏的一环 验证方式
多域名 SAN 各 server 块共用的 fullchain server_name 未列入 SAN openssl x509 -ext subjectAltName
通配符 单文件覆盖一级子域 误以为覆盖多级子域 同上,逐条比对域名
SNI 多证书 各 server 独立 ssl_certificate default_server 仍是旧证书 s_client -servername 逐个测
CDN / 云 LB 边缘节点证书 + 回源证书 只换边缘、回源仍是旧证书 控制台核对“域名绑定”与“回源协议”
RSA + ECDSA 双证书 同一 server 两行 ssl_certificate 先删旧证书导致兼容性回退 s_client -cipher 分别握手
内部 mTLS / 数据库 PostgreSQL ssl_cert_file、MySQL ssl_ca/ssl_cert/ssl_key、Kafka ssl.keystore.location 只换入口,内部链路未同步 应用日志中的 SSLHandshakeException

CDN 与云负载均衡要同时看两处:边缘证书是否已绑定新域名,以及回源协议。若回源走 HTTPS,源站证书过期一样返回 502,Nginx 侧日志会出现 upstream SSL certificate verify error: (10:certificate has expired);内网可信时可把回源改为 HTTP,否则必须同步替换源站证书。灰度替换建议利用 Nginx 1.11.0+ 支持在同一 server 内写两组 ssl_certificate 的特性,先加新证书、确认无误再删旧证书:

server {
    listen 443 ssl;
    server_name example.com;
    # Nginx 1.11.0+ 支持 RSA/ECDSA 双证书,按客户端能力自动择优,顺序无关
    ssl_certificate     /etc/nginx/ssl/fullchain-ecdsa.pem;   # 新增的 ECDSA 证书
    ssl_certificate_key /etc/nginx/ssl/privkey-ecdsa.pem;
    ssl_certificate     /etc/nginx/ssl/fullchain-rsa.pem;     # 旧 RSA 证书,验证通过后再删
    ssl_certificate_key /etc/nginx/ssl/privkey-rsa.pem;
}

至于内部链路,PostgreSQL 的 ssl_cert_file 默认值即 server.crt,MySQL 需同时更新 ssl_ca、ssl_cert、ssl_key 三项并重启(ssl_cert 不支持热加载),Kafka 则替换 ssl.keystore.location 指向的 JKS/PKCS12。只换入口证书、内部仍是旧 CA 链时,客户端会抛 javax.net.ssl.SSLHandshakeException: PKIX path validation failed: certificate has expired——这也是“SSL证书过期怎么配置”里最容易被忽略的一半。

浏览器会显示全屏警告,Chrome 常见报错是 NET::ERR_CERT_DATE_INVALID,API 客户端通常直接失败;HSTS 站点无法点“继续访问”。服务器本身仍能完成 TCP 连接,但 TLS 校验失败,用户看到的是证书错误页而不是正常内容。

用 nginx -t 检查后执行 systemctl reload nginx 或 nginx -s reload,新 worker 加载新证书,旧 worker 处理完存量连接后退出;设置 worker_shutdown_timeout 30s 可缩短新旧证书并存窗口。只有改监听端口、模块等才需要 restart。

常见四种原因:没有 reload、改错了 server 块、多节点只换了一台、前面有 CDN 或负载均衡没更新。用 curl –resolve 指到源站 IP 先验证源站,再逐层查 CDN 和 LB 的证书绑定。

说明证书与私钥不是同一对。用 openssl x509 -noout -pubkey 与 openssl pkey -pubout 比对,或 RSA 用 -modulus | openssl md5 比对,换成匹配私钥后 nginx -t 再 reload。若报 ee key too small,则是 RSA 小于 2048 位。

不需要逐个改配置,但所有使用该证书的 server 块都要指向新的 fullchain 路径并 reload;若各子域共用同一文件路径,替换文件后逐台 reload 即可。注意 *.example.com 不覆盖 a.b.example.com 这类二级子域。

不能。据 Let's Encrypt 文档其证书固定 90 天;公开 TLS 证书受 CA/Browser Forum 约束,2020-09-01 起上限 398 天,SC-081 计划 2026-03-15 降至 200 天。想降低操作频率应做自动续期 + reload 钩子 + 到期告警;付费 DV 年费大致 50-500 元、OV 800-3000 元,买 1 年证书也不能突破 398 天上限。

核对证书与域名绑定、SNI、回源协议;若回源是 HTTPS,源站证书也要换,否则 LB 到源站握手失败。用 curl –resolve 直连源站和直连 LB 分别验证,避免只看了入口证书。


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

内容审核

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