跳到主要内容
SSL 证书付费服务

SSL/TLS 证书与 HTTPS 配置故障排查实战(Nginx / Apache / IIS 全流程)

SSL/TLS 证书与 HTTPS 配置故障排查实战(Nginx / Apache / IIS 全流程) — 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 因系统自动补链却显示正常。

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 密钥,并建立到期前自动告警机制。

内容审核

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