SSL/TLS 证书与 HTTPS 配置故障排查实战(Nginx / Apache / IIS 全流程)
一、HTTPS 证书故障为什么频发:背景与根因
HTTPS 早已是网站默认配置,但证书类故障依然排在运维工单前列。原因不是技术难,而是证书有生命周期、有链式信任、有平台差异:一张证书要同时被 Chrome、Safari、Android WebView、Java 客户端、curl 认可,任何一个环节缺失都会报错。更关键的是有效期在不断缩短——CA/Browser Forum 规定自 2020-09-01 起,公开信任的 TLS 证书最长有效期不得超过 398 天,Let’s Encrypt 签发的免费证书固定 90 天。任何”买三年送两年”的说法都已不符合规范,靠人工记忆续期必然出事故。
把线上 HTTPS 故障归因,基本逃不出下面八类:
| 故障类别 | 典型现象 | 根因 |
|---|---|---|
| 证书过期 | NET::ERR_CERT_DATE_INVALID | 未续期;服务器时间偏差超出 notBefore/notAfter |
| 证书链不完整 | unable to verify the first certificate | 只部署站点证书,缺中间证书 |
| 域名不匹配 | NET::ERR_CERT_COMMON_NAME_INVALID | SAN 未包含实际访问域名(如漏 www) |
| 私钥不匹配 | key values mismatch | 多套证书混用,复制错文件 |
| 协议/套件不兼容 | sslv3 alert handshake failure | 仅开 TLS 1.0/1.1,或套件过旧 |
| SNI 缺失 | 返回默认站点证书 | 多域名共用 IP,未启用 SNI |
| 混合内容 | 锁标带警告三角 | 页面内引用 http:// 资源 |
| 端口/防火墙 | curl: (7) Failed to connect | 443 未放行、安全组未开、进程未监听 |
排查顺序建议固定为:先验证文件(证书/私钥/链)→ 再验证服务端配置语法 → 最后从客户端侧抓握手包。反过来做,往往会在浏览器报错上绕很久。下面按 Linux(Nginx/Apache)与 Windows(IIS)两条主线给出可直接执行的命令与配置。
二、排查前的自检:证书、私钥、CSR 与证书链
改配置前先把四个文件确认清楚:站点证书 cert.pem、中间证书 chain.pem、完整链 fullchain.pem(= cert.pem + chain.pem,顺序不可颠倒)、私钥 privkey.key。绝大多数”配置明明没错却不生效”都出在这四个文件上。
1. 查看证书主体、有效期与 SAN
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
重点核对 notAfter 与 X509v3 Subject Alternative Name。现代浏览器只看 SAN,不再看 CN 字段,所以 CN 正确但 SAN 缺失同样报错。
2. 校验证书与私钥是否配对
openssl x509 -in cert.pem -noout -modulus | openssl sha256
openssl rsa -in privkey.key -noout -modulus | openssl sha256
两行哈希必须完全一致。若私钥是 ECC(ECDSA),改用公钥指纹比对:
openssl pkey -in privkey.key -noout -pubout -outform der | openssl sha256
openssl x509 -in cert.pem -noout -pubkey | openssl pkey -pubin -outform der | openssl sha256
3. 验证证书链完整性
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
返回 cert.pem: OK 才算通过;报 unable to get local issuer certificate 说明缺中间证书,需要向 CA 下载完整链。
4. 需要重签时生成 CSR(带 SAN)
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'
-addext 需要 OpenSSL 1.1.1 及以上;旧版本改用带 SAN 的配置文件加 -reqexts。提交前用 openssl req -in example.com.csr -noout -text 复核 SAN,漏掉 www 子域是后续域名不匹配报错的头号原因。
三、Nginx 证书配置与排错实操
Nginx 的坑集中在一点:ssl_certificate 只写了站点证书,中间证书没拼进去。浏览器(尤其桌面 Chrome)有时会自己补链,但 Android、Java、部分 SDK 不会。
1. 完整的 server 段配置
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+;旧版本写 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 必须含中间证书
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options nosniff always;
}
2. 合并与校验完整链
cat example.com.crt intermediate.crt > fullchain.pem
grep -c 'BEGIN CERTIFICATE' fullchain.pem # 正常应 ≥ 2
3. 语法检查与平滑重载
nginx -t
nginx -s reload # 或 systemctl reload nginx
4. 真实启动报错对照
nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
→ 证书与私钥不配对,回到第二节用 modulus 比对。
nginx: [emerg] PEM_read_bio_X509_AUX("/etc/nginx/ssl/fullchain.pem") failed (SSL: error:0909006C:PEM routines:get_name:no start line)
→ 文件是 DER 格式或空文件,用 openssl x509 -inform der -in cert.der -out cert.pem 转换后再部署。
5. 多域名共用 443:Nginx 默认按 SNI 匹配 server_name,无需额外开关;但客户端不支持 SNI 时会落到第一个 server 块,因此主站应放在最前面,或对老客户端单独分配 IP。
四、Apache 证书配置与排错实操
Apache 2.4.8 是分水岭:2.4.8 之前必须用 SSLCertificateChainFile 单独指定中间证书;2.4.8 之后该指令被废弃(仍兼容),官方推荐把中间证书直接拼接进 SSLCertificateFile。
1. 完整 VirtualHost 配置
<VirtualHost *:443>
ServerName example.com
DocumentRoot /var/www/html
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# Apache < 2.4.8 才需要下面这行
# SSLCertificateChainFile /etc/httpd/ssl/chain.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
SSLSessionTickets off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
注意 SSLCACertificateFile 是给客户端证书双向认证用的,把它当中间证书用是典型误配——服务能起来,但浏览器仍然报链不完整。
2. 检查与重载
apachectl configtest # CentOS 也可用 httpd -t
systemctl reload httpd # Debian/Ubuntu: systemctl reload apache2
3. 真实报错对照
AH00526: Syntax error on line 12 of /etc/httpd/conf.d/ssl.conf:
SSLCertificateFile: file '/etc/httpd/ssl/fullchain.crt' does not exist or is empty
→ 路径错误、权限不足(httpd 运行用户读不到)或文件为空。用 ls -l 与 sudo -u apache cat /etc/httpd/ssl/fullchain.crt 分别验证。
AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate!
→ 开了 SSLUseStapling on 但缺少中间证书或缓存定义,补上 SSLStaplingCache shmcb:/var/run/ocsp(128000) 并确保链完整。
AH02564: Failed to configure encrypted (?) private key /etc/httpd/ssl/example.com.key
→ 私钥带口令,启动时无法交互输入。用 openssl rsa -in enc.key -out dec.key 解密(会提示输入口令),随后 chmod 600 dec.key。
五、Windows / IIS 环境的证书导入与绑定排查
Windows 上最常见的问题是 PFX 只导入了站点证书、中间证书没进”中间证书颁发机构”存储,导致 Firefox、Android 报链不完整,而 IE/Chrome 因系统自动补链却显示正常。
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- 服务器维护 · 网站代维护 · 服务器托管代维
1. 导入含完整链的 PFX
Import-PfxCertificate -FilePath C:certsexample.com.pfx `
-CertStoreLocation Cert:LocalMachineMy `
-Password (ConvertTo-SecureString -String 'P@ssw0rd' -AsPlainText -Force)
若手上只有 crt + key,先用 OpenSSL 合成 PFX(-certfile 指定中间证书,缺了它就等于没有链):
openssl pkcs12 -export -out example.com.pfx
-inkey example.com.key -in cert.pem -certfile chain.pem -passout pass:P@ssw0rd
2. 绑定 443 端口
netsh http show sslcert
netsh http add sslcert ipport=0.0.0.0:443 certhash=<证书指纹> appid={4dc3e181-e14b-4a21-b022-59fc669b0914}
IIS 8 及以上多站点共用 443 时,绑定界面必须勾选”需要服务器名称指示”,否则所有域名都返回默认站点证书,浏览器报 ERR_CERT_COMMON_NAME_INVALID。
3. 排查端口与防火墙
netstat -ano | findstr :443
Get-Process -Id <PID>
New-NetFirewallRule -DisplayName "HTTPS 443" -Direction Inbound -Protocol TCP -LocalPort 443 -Action Allow
4. 私钥读取权限:导入后右键证书 → 所有任务 → 管理私钥,为 IIS_IUSRS 授予读取权限;漏掉这一步的典型现象是站点已启动、443 却完全无响应。
5. 时间同步:用 w32tm /query /status 检查系统时间源。时间偏差超过证书 notBefore,客户端同样报 ERR_CERT_DATE_INVALID,而服务器端日志毫无异常。
六、三平台配置项与证书有效期对比
把三套平台的配置项放在一起对照,能快速定位”文档抄错了平台”这类低级错误。
表 1:Nginx / Apache / IIS 证书配置对照
| 配置项 | Nginx | Apache | IIS / Windows |
|---|---|---|---|
| 站点证书 | ssl_certificate | SSLCertificateFile | 证书存储 LocalMachineMy |
| 私钥 | ssl_certificate_key | SSLCertificateKeyFile | 随 PFX 一并导入 |
| 中间证书 | 拼接进 fullchain.pem | SSLCertificateChainFile(<2.4.8)或拼接 | 中间证书颁发机构存储 |
| 协议控制 | ssl_protocols | SSLProtocol | 注册表 / IIS Crypto |
| 加密套件 | ssl_ciphers | SSLCipherSuite | 组策略 / IIS Crypto |
| OCSP 装订 | ssl_stapling | SSLUseStapling | 不支持,依赖系统 |
| 配置检查 | nginx -t | apachectl configtest | 无,查事件查看器 |
| 生效方式 | nginx -s reload | systemctl reload httpd | iisreset /restart |
| SNI 支持 | 默认支持 | 2.2.12+ 默认支持 | IIS 8+ 需手动勾选 |
表 2:证书有效期与续期方式
| 证书类型 | 最长有效期 | 推荐续期方式 | 适用场景 |
|---|---|---|---|
| 公开信任 DV/OV/EV | 398 天 | 到期前 30 天重新签发 | 对外生产站点 |
| Let’s Encrypt | 90 天 | ACME 自动续期(certbot –deploy-hook 重载) | 对外生产站点,推荐 |
| 企业私有 CA | 自定义(常见 1-3 年) | 内部审批流程 | 内网、微服务 mTLS |
| 自签名 | 自定义 | 手动 | 仅限测试环境 |
补充两点:398 天是上限而非推荐值,把有效期压到 90 天并全自动化,才是当前业界通行做法;Nginx 1.11.0+ 支持 RSA + ECDSA 双证书,可在同一个 server 块里写两组 ssl_certificate / ssl_certificate_key,兼顾老客户端与现代浏览器的套件偏好。
七、常见错误与真实报错排查
1. 浏览器 NET::ERR_CERT_DATE_INVALID:先看服务器时间,再验证书有效期。
date -u
timedatectl set-ntp true # 或 systemctl enable --now chronyd
chronyc sources -v
openssl x509 -in fullchain.pem -noout -dates
2. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID:从外部抓服务端实际下发的证书,确认 SAN。
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -ext subjectAltName
如果抓到的证书属于别的域名,说明 SNI 未生效或 server 块顺序错误。
3. curl: (60) SSL certificate problem: unable to get local issuer certificate:典型缺链。用 curl -vI https://example.com 看服务端返回了几张证书,只有 1 张就是缺中间证书。
4. Java 客户端 PKIX path building failed:JDK 的 cacerts 不认该 CA 或缺少中间证书。导入根证书:
keytool -importcert -alias myca -file root.crt -keystore $JAVA_HOME/lib/security/cacerts
5. Mixed Content:控制台报 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 'http://...'。除逐条改链接外,可先加响应头兜底:
add_header Content-Security-Policy "upgrade-insecure-requests" always;
6. sslv3 alert handshake failure:客户端与服务端无共同协议或套件。用 openssl s_client -connect example.com:443 -tls1_2 逐版本测试,确认已禁用 TLS 1.0/1.1(RFC 8996 已正式弃用)。
7. curl: (7) Failed to connect to example.com port 443:与证书无关,是网络层。检查 ss -lntp | grep 443、安全组、云防火墙、本机 iptables/nftables。
八、效果验证与上线后监控
配置改完不要只看浏览器锁标,用命令行做一次完整验收:
# 握手信息、协议版本、证书链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 确认 TLS 1.0/1.1 已关闭(应当失败)
openssl s_client -connect example.com:443 -servername example.com -tls1 </dev/null
# 支持的协议与套件枚举
nmap --script ssl-enum-ciphers -p 443 example.com
# 检查 HSTS 是否下发
curl -sI https://example.com | grep -i strict-transport-security
# 30 天内过期告警(返回 0 表示未过期)
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -checkend 2592000 || echo '证书将在 30 天内过期'
在线评分建议用 SSL Labs(ssllabs.com/ssltest),目标 A 及以上;若要提交 HSTS preload 列表,需 max-age 不低于 31536000 且带 includeSubDomains。
自动化续期必须演练:certbot renew --dry-run 能跑通再上线。生产环境建议加 blackbox_exporter 做外部探测,告警规则示例:
- alert: SSLCertExpiringSoon
expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 21
for: 1h
labels:
severity: warning
annotations:
summary: "{{ $labels.instance }} 证书将在 21 天内过期"
最后一步是回归客户端矩阵:Chrome、Safari(iOS)、Android WebView、curl、Java 客户端各测一次。桌面浏览器通过不代表移动端通过,这是证书链问题最典型的”半通过”现象。
常见问题
证书最长有效期 398 天是怎么来的?还能买多年期证书吗?
398 天来自 CA/Browser Forum 的 Baseline Requirements:自 2020-09-01 起,所有公开信任的 TLS 证书有效期上限被压缩到 398 天(含到期当天)。因此市面上所谓”三年期证书”实际上是 CA 一次性签发多张 398 天以内的证书、按年下发,或者只是把服务期打包售卖,单张证书本身仍然不超过 398 天。采购时应问清”单张证书的 notAfter 是哪天”,并确认续期是否需要重新提交 CSR、是否需要重新做域名验证。把续期动作自动化(ACME 或 CA 提供的 API)比买长周期套餐更可靠。
Let’s Encrypt 只有 90 天,怎么避免忘记续期?
核心是把续期从”人工操作”变成”定时任务 + 自动重载”。典型做法是用 certbot 的 systemd timer(systemctl list-timers | grep certbot)或 cron 每天跑一次 certbot renew --quiet --deploy-hook 'systemctl reload nginx'。certbot 只在剩余有效期小于 30 天时才会真正续签,因此每天执行不会造成重复签发和速率限制。上线前务必执行 certbot renew --dry-run 验证整条链路(包括 80/443 的 ACME 挑战端口是否可达)。另外建议加一层外部监控:用 openssl 或 blackbox_exporter 从公网探测证书剩余天数,21 天时告警,避免定时任务静默失败。
为什么浏览器显示锁标正常,但 Android 或 Java 客户端报证书错误?
这是证书链不完整的典型表现。桌面 Chrome/Edge 在 Windows 与 macOS 上会利用系统证书存储”补链”,即使服务端只下发了站点证书,也能凑出完整路径;而 Android、Java、Python requests、部分 SDK 只认服务端实际下发的证书序列。验证方法是 openssl s_client -connect 域名:443 -servername 域名 -showcerts,数一下返回了几张证书——只有 1 张就说明缺中间证书。修复方式是 cat cert.crt chain.crt > fullchain.pem,并让 Nginx 的 ssl_certificate 指向 fullchain、Apache 2.4.8+ 让 SSLCertificateFile 指向 fullchain、IIS 把中间证书导入”中间证书颁发机构”存储。
一张证书能绑定多少个域名?多域名和通配符怎么选?
取决于证书的 SAN 数量,与平台无关。单域名证书只含 1 个 FQDN;多域名证书(SAN/UCC)通常可含 2 到 100 个域名,主流 CA 默认给 5 个左右,超出需额外购买;通配符证书 *.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com。实践建议:子域数量少且固定时用多域名证书;子域动态增长(如每个租户一个子域)用通配符,并把根域单独加入 SAN。注意通配符证书一旦私钥泄露影响面更大,需配合 chmod 600、最小权限与密钥轮换策略。
HTTP 和 HTTPS 同时存在,重定向怎么写才不出错?
原则是 80 端口只做跳转、不做内容服务,且跳转目标必须是 https 的同一路径。Nginx 写法:server { listen 80; server_name example.com www.example.com; return 301 https://$host$request_uri; }。不要用 rewrite 拼绝对地址,避免反代场景下拿到内网主机名。Apache 用 Redirect permanent / https://example.com/ 或 RewriteRule ^(.*)$ https://%{HTTP_HOST}$1 [R=301,L]。若前面有负载均衡或 CDN 做 TLS 卸载,源站判断协议要看 X-Forwarded-Proto,否则会陷入无限重定向——这是最典型的 301 循环成因,排查时用 curl -I 看跳转链即可定位。
自签名证书能用在生产环境吗?
对外提供服务的站点不能。自签名证书不在浏览器与操作系统的信任存储中,用户会看到全屏红色警告,且无法通过 HSTS preload,SEO 与用户信任都会受损。自签名证书的合理场景是内网测试、开发环境、以及由企业私有 CA 签发的内部服务——后者需要把根证书通过组策略或 MDM 下发到所有客户端,并纳入与公开证书同等效期的管理流程。无论哪种,都必须禁用 TLS 1.0/1.1、使用至少 2048 位 RSA 或 256 位 ECDSA 密钥,并建立到期前自动告警机制。