微信打开网站证书错误怎么解决?从根因到 Nginx 配置与真机验证的完整排查指南
微信打开网站证书错误通常不是微信单独拦截,而是服务端证书链不完整、域名/时间不匹配或客户端根证书不受信任导致;用 openssl s_client -showcerts 检查并补全中间证书,多数可在 10 分钟内恢复。;检查顺序是证书链、SAN 域名、有效期、根证书兼容、TLS 协议与 CDN 回源,任何一项失败都会让微信内置浏览器报错。;Nginx 的 ssl_certificate 必须指向 fullchain.pem,顺序为叶证书在前、中间证书在后,根证书不要放入,改完执行 nginx -t && systemctl reload nginx。;Let's Encrypt 证书有效期 90 天,旧 Android 设备要关注 ISRG Root X1 信任问题,必要时保留交叉链或换 DigiCert Global Root G2 等根。;验证时以 openssl s_client 输出 Verify return code: 0 (ok) 为准,再用 iOS 与 Android 微信 8.0.x 真机各测一次。
微信打开网站为什么提示证书错误?先看这 5 类根因
微信打开网站证书错误,先别急着改 Nginx——微信内置浏览器本身不实现 TLS:Android 走 X5/XWeb 内核,iOS 走 WKWebView,最终都依赖系统信任库和系统 TLS 栈做校验。这正是”桌面 Chrome 正常、微信一片红”的根源:桌面浏览器有证书缓存、会走 AIA(Authority Information Access)扩展去自动下载中间证书,而微信这条路径通常走不通。据 RFC 5280 第 6 节,认证路径必须从终端证书一路可验证到本地信任锚,缺任何一环都算失败。下面 5 类根因覆盖了绝大多数真实工单。
-
根因 1:证书链不完整(占比最高)。Nginx 只配了
example.com.crt,漏掉intermediate.crt,服务端只回 1 张证书。Let’s Encrypt 官方文档明确要求使用fullchain.pem,它包含叶证书 + R3/R10/R11 中间证书,部分场景还需 ISRG Root X1 交叉链。# 统计服务端实际下发的证书张数,正常为 2~3 张 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE" # 输出 1 → 证书链断裂,微信必报错;输出 2/3 → 链完整 # Nginx 正确写法(Let's Encrypt,certbot 默认路径) ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 关键:fullchain 而非 cert ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_protocols TLSv1.2 TLSv1.3; # nginx 1.23+ 默认即为 TLSv1.2/1.3 -
根因 2:域名不匹配。证书 SAN 不含用户实际访问的主机名时,微信直接抛
ERR_CERT_COMMON_NAME_INVALID。注意通配符*.example.com只覆盖一级子域,既不覆盖裸域example.com,也不覆盖a.b.example.com。openssl x509 -in fullchain.pem -noout -text | grep -A1 "Subject Alternative Name" # 示例输出:DNS:example.com, DNS:www.example.com → 缺 m.example.com 就会在微信端报错 -
根因 3:时间偏差与根信任缺失。服务器 UTC 时间偏差超过 300 秒、证书过期或尚未生效都会失败;Android 7 及以下、长期未更新根证书的机型可能不信任 ISRG Root X1,需保留交叉链,或改用 DigiCert Global Root G2、GlobalSign Root R3 等兼容性更好的根。
date -u # 对比真实 UTC 时间,偏差 >300s 即高危 openssl x509 -in fullchain.pem -noout -dates # notBefore / notAfter 是否覆盖当前时间 -
根因 4:TLS 协议或密码套件不兼容。仅开 TLSv1.0/1.1、只部署 RSA 证书而客户端偏好 ECDSA、或套件被系统 WebView 拒绝,表现都是握手失败而非”证书错误”。Mozilla SSL Configuration Generator 的 Intermediate 配置建议仅保留 TLSv1.2/1.3;微信 8.0.x 在 Android 10+ 上基本要求 TLS 1.2 及以上。
# 用 TLS 1.1 探测,应返回 handshake failure(说明已按建议关闭) openssl s_client -connect example.com:443 -tls1_1 -servername example.com </dev/null -
根因 5:代理 / CDN / WAF 改写。CDN 回源走 HTTP、回源 443 的证书与回源域名不匹配、WAF 拦截 SNI、负载均衡只部署叶证书,都会让”源站没问题、线上必报错”。用
--resolve绕过 DNS 直连源站做对比最快:curl -vI --resolve example.com:443:203.0.113.10 https://example.com 2>&1 | grep -E "subject:|issuer:|SSL certificate" # 与不加 --resolve(走 CDN)的输出对比 issuer 与证书张数是否一致
| 根因 | 微信端典型表现 | 最快验证命令 |
|---|---|---|
| 证书链不完整 | iOS 提示”无法验证服务器身份” | s_client -showcerts | grep -c BEGIN |
| 域名不匹配 | ERR_CERT_COMMON_NAME_INVALID | x509 -text | grep DNS |
| 时间/根信任 | ERR_CERT_DATE_INVALID、老机型专属失败 | date -u、x509 -dates |
| 协议/套件不兼容 | 空白页或 ERR_SSL_PROTOCOL_ERROR | s_client -tls1_1 |
| CDN/WAF 改写 | 仅线上域名失败,源站 IP 正常 | curl --resolve 对比 issuer |
从报错到修复:微信证书错误的 6 步实操流程
排查顺序错了最容易白折腾:很多人一看到微信打开网站证书错误,第一反应是清微信缓存、重装微信。但如果同一 URL 在手机系统浏览器里也报错,问题就出在服务端证书链、域名或有效期上,微信只是替罪羊。下面 6 步按“先证伪、再取证、后修复”排列,命令可直接复制。
- 记录复现环境,先用系统浏览器证伪。记下微信版本(iOS/Android 8.0.4x)、机型、网络(4G 还是 Wi-Fi)、访问的完整域名(带不带 www 结果可能不同)。然后用 Safari / Chrome 打开同一 URL:系统浏览器也报错,直接跳到步骤 2 查证书链、SAN 和有效期;只有微信报错、系统浏览器正常,才去怀疑微信 WebView 缓存或 iOS 证书信任开关。这一步能省掉 80% 的无效操作。
- 拉取服务端真实证书链。
# -servername 不可省,否则 SNI 站点可能拿到默认证书,结论就错了 openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts chain.txt 2>&1 # 只看关键两行:链中证书张数 与 校验结论 grep -E "Verify return code|^ *[0-9]+ s:" chain.txt正常应返回 2–3 张证书(1 张叶证书 + 1–2 张中间证书),并出现
Verify return code: 0 (ok)。若返回21 (unable to verify the first certificate),说明服务端只发了叶证书、中间证书缺失——这是微信报错最高频的根因;返回20 (unable to get local issuer certificate)则多为链不完整或客户端缺根。 - 逐项核对证书字段。
# OpenSSL 1.1.1+ 支持 -ext;1.0.2 请改用 -text 后人工查找 openssl x509 -in server.crt -noout -subject -issuer -dates -ext subjectAltNamesubject=CN = www.example.com issuer=C = US, O = Let's Encrypt, CN = R3 notBefore=Feb 1 00:00:00 2025 GMT notAfter=May 2 23:59:59 2025 GMT X509v3 Subject Alternative Name: DNS:www.example.com, DNS:example.com三看:SAN 是否含实际访问域名(只写在 CN 里、新客户端不认)、notBefore/notAfter 是否覆盖当前时间(注意 GMT 时区)、issuer 是否为自签或私有 CA。
- 补全链并重载。Nginx 的
ssl_certificate必须指向“叶证书 + 中间证书”的拼接文件,顺序叶在前:# 拼接 fullchain,顺序不能反 cat server.crt intermediate.crt > /etc/nginx/ssl/fullchain.pem # nginx.conf server { listen 443 ssl; server_name www.example.com; ssl_certificate /etc/nginx/ssl/fullchain.pem; # 叶+中间证书 ssl_certificate_key /etc/nginx/ssl/privkey.key; # 私钥单独存放 ssl_protocols TLSv1.2 TLSv1.3; # 默认值随版本变化,显式声明更稳 } nginx -t && systemctl reload nginxApache 2.4.57 的
SSLCertificateFile直接指向 fullchain 即可,2.4.8 之前的旧版本才需要额外配置SSLCertificateChainFile:SSLCertificateFile /etc/httpd/ssl/fullchain.crt SSLCertificateKeyFile /etc/httpd/ssl/privkey.key # SSLCertificateChainFile /etc/httpd/ssl/chain.crt # 仅 2.4.8 之前的版本需要 - 处理根证书兼容性。据 Let’s Encrypt 官方公告,自 2024-06-06 起默认链不再提供交叉签名,只发 ISRG Root X1 自签根;而 Android 7.1.1 及更早系统未内置该根,这类设备上会直接失败。选型参考:
方案 覆盖 Android 7.1.1 及以下 成本 说明 Let’s Encrypt 默认链(ISRG Root X1) 否 免费 2024-06-06 起无交叉签名可选 商业 CA(如 DigiCert Global Root G2) 视根证书内置时间而定 付费 上线前核对目标系统信任列表 私有 CA / 自签证书 否 免费 需手动装根,微信 WebView 内通常不可行 不要引导用户在手机上安装来源不明的根证书,既通不过微信校验,也存在中间人风险。
- 真机回归。微信内把页面退出到后台再重新进入(或“设置-通用-存储空间”清缓存);iOS 检查“设置-通用-关于本机-证书信任设置”是否误关了该根;Android 在“网络和互联网-私人 DNS”改为关闭(默认“自动”可能指向过滤型 DoH)。最后连续访问 3 次并来回切换 Wi-Fi / 4G,确认不是单一路径或某个 CDN 节点回源证书不一致导致的偶发微信打开网站证书错误。
Nginx、Apache 与 OpenSSL 怎么配?可直接复制的命令和参数
证书文件本身没错,但服务器只发了叶证书、漏了中间证书,微信内置浏览器(Android 上走系统 WebView,iOS 上走 WKWebView)就会直接弹出「证书无效」。这一节给出 Nginx、Apache 与 OpenSSL 三处的可直接复制配置,以及验证链是否完整的命令。
Nginx 1.24.x 的最小可用配置(据 Mozilla SSL Configuration Generator 的 intermediate 档位,仅需 TLS 1.2/1.3 兼容性即可覆盖微信内置浏览器):
# /etc/nginx/conf.d/example.conf
server {
listen 443 ssl;
http2 on; # 1.25.1+ 推荐写法,旧版用 listen 443 ssl http2;
server_name www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 必须含中间证书
ssl_certificate_key /etc/nginx/ssl/privkey.pem; # 权限 600,属主 root
ssl_protocols TLSv1.2 TLSv1.3; # 1.23.4 起默认值即为此
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers off; # 1.23.4 起默认 off,交给客户端选更优
ssl_session_cache shared:SSL:10m; # 默认 none,10m 约缓存 4 万个会话
ssl_session_timeout 1d; # 默认 5m
}
改完先跑 nginx -t,输出 syntax is ok 与 test is successful 两行再 nginx -s reload。少一行都说明配置没生效,此时微信里的报错自然也不会消失。
合并 fullchain 的顺序不能错。顺序必须是叶证书在前、中间证书在后,根证书不要放进去——根证书已在客户端信任库中,重复下发只会增大握手包:
cat example.com.crt intermediate.crt > fullchain.pem
grep -c 'BEGIN CERTIFICATE' fullchain.pem # 正常输出 2;若为 3 检查是否混入根证书
openssl x509 -in fullchain.pem -noout -subject # 第一张应为你的域名
Apache 2.4.57 的等价配置:
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.crt
SSLCertificateKeyFile /etc/httpd/ssl/privkey.key
SSLProtocol -all +TLSv1.2 +TLSv1.3 # 2.4.x 默认 all -SSLv3,需显式收紧
SSLCipherSuite HIGH:!aNULL:!MD5
</VirtualHost>
# 校验并热加载
apachectl configtest && systemctl reload httpd
| 能力 | Nginx 1.24.x 指令 | Apache 2.4.57 指令 | 默认值提示 |
|---|---|---|---|
| 证书链 | ssl_certificate | SSLCertificateFile | Nginx 直接读 fullchain;Apache 2.4.8+ 也支持单文件含链 |
| 私钥 | ssl_certificate_key | SSLCertificateKeyFile | 均要求 PEM,不可带口令 |
| 协议版本 | ssl_protocols | SSLProtocol | Nginx 默认 TLSv1.2/1.3;Apache 默认含 SSLv3 需关闭 |
| 加密套件 | ssl_ciphers | SSLCipherSuite | 均需排除 aNULL/MD5 |
验证链是否真的完整,别只信浏览器:
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted intermediate.crt example.com.crt
# 期望输出:example.com.crt: OK
# 若报 unable to get local issuer certificate → 缺中间证书或顺序颠倒
线上再补一刀:openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts,看输出里有几个 s: 段,只有 1 段就是没带中间证书,这正是微信打开网站证书错误最常见的一条根因。
OCSP Stapling(可选但建议开),能减少微信端因 OCSP 查询超时导致的握手失败:
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 含中间证书,不含叶证书
resolver 223.5.5.5 119.29.29.29 valid=300s;
# 验证:看到 OCSP Response Status: successful 且响应体非空即成功
openssl s_client -connect www.example.com:443 -status < /dev/null | grep -A1 "OCSP Response Status"
自动续期别忘联动 reload。据 Let’s Encrypt 文档,certbot 2.x 先用 certbot renew --dry-run 演练,确认无误后由 systemd 定时器触发;续期只替换磁盘文件,Nginx 仍持旧证书句柄,必须 reload:
certbot renew --dry-run # 演练,不实际签发
systemctl list-timers | grep certbot # 确认 certbot.timer 处于 active
# 续期后钩子(/etc/letsencrypt/renewal-hooks/deploy/reload.sh)
nginx -t && nginx -s reload
最后一句实操建议:配置改完后不要只在桌面 Chrome 里看绿锁,用微信真机扫码打开一次,再配合上面的 openssl s_client 输出比对,才能确认微信打开网站证书错误是真被修好了还是只是被缓存掩盖了。
证书类型和部署方案怎么选?免费、DV、OV、通配符与 CDN 对比
很多人以为”买个 OV 或 EV 证书,微信就不报错了”——这是最常见的误解。微信内置浏览器(iOS 用 WKWebView,Android 多为 X5 内核)做的是标准 TLS 握手,按 RFC 5280 逐级验证证书链、有效期、域名匹配和吊销状态,证书里写的是 DV 还是 OV/EV,握手层根本不参与判断。OV/EV 只是把组织信息写进 Subject 字段,浏览器地址栏早已不再区别展示。所以微信里出现证书错误时,换更贵的证书类型通常无效,真正该查的是三件事:根证书是否被设备信任、SAN 是否覆盖你访问的那个域名、中间证书是否完整下发。据 Let’s Encrypt 文档,其证书有效期 90 天、依赖 ISRG Root X1,Android 7.1.1 以下设备若缺少该根,需要靠交叉签名链兜底——这才是”安卓微信报证书错误”的高频根因。
先看覆盖范围。通配符 *.example.com 只匹配一级子域:www.example.com、api.example.com 通过,example.com(裸域)和 a.b.example.com(二级)都不通过。需要裸域 + 多级子域时,选 SAN 多域名证书,并让 Nginx 的 server_name 与证书 SAN 严格对齐。部署前用一条命令确认:
# 查看证书实际覆盖了哪些域名(SAN 才是校验依据,CN 已被主流客户端忽略)
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -ext subjectAltName
# 期望输出示例:
# X509v3 Subject Alternative Name:
# DNS:*.example.com, DNS:example.com
# 带 SNI 抓取线上真实下发的证书链,确认与本地文件一致
openssl s_client -connect www.example.com:443 -servername www.example.com
-showcerts /dev/null | openssl x509 -noout -subject -issuer -dates
选型对比(价格为常见公开报价区间,实际以 CA 或代理商为准):
| 方案 | 价格区间 | 有效期 | 覆盖范围 | 微信端关键注意点 |
|---|---|---|---|---|
| Let’s Encrypt DV 单域名 | 0 元 | 90 天 | 1 个精确域名 | 必须部署 fullchain.pem;旧 Android 关注 ISRG Root X1 |
| 商业 DV 单域名(如 Sectigo) | 约 100–500 元/年 | 1 年 | 1 个精确域名 | 根信任面广、签发快,适合不想跑 ACME 的场景 |
| DV 通配符 | 约 500–1500 元/年 | 1 年 | *.example.com 一级子域 | 不含裸域,需另加 SAN |
| OV/EV 单域名(如 DigiCert) | 约 800–6000 元/年 | 1 年 | 1 个精确域名 | 微信不因 OV/EV 放宽任何校验 |
| CDN 托管证书(阿里云/EdgeOne/Cloudflare) | 0–3000 元/年 | 随套餐 | 视套餐 | 回源段仍要单独校验证书 |
用 CDN 或 WAF 时最容易踩的坑在回源链路:用户到 CDN 是 HTTPS,CDN 到源站也必须走 HTTPS 443 并上传回源证书,且回源域名、SNI、源站证书 SAN 三者要一致,否则会出现 Cloudflare 525(SSL handshake failed)或 526(invalid SSL certificate)一类错误。排查时直接对源站 IP 发请求,绕过 CDN 验证:
# 直连源站 IP 但用真实域名做 SNI 与 Host,判断回源证书是否匹配
curl -sv --resolve www.example.com:443:203.0.113.10 https://www.example.com/ -o /dev/null
# 若报 certificate subject name does not match,说明源站证书 SAN 没包含回源域名
兼容性上还有一步值得做:Nginx 自 1.11.0 起支持在同一个 server 块里写两组 ssl_certificate,分别挂 RSA 与 ECDSA 证书,由客户端能力自动选择;老 Android 设备往往只支持 RSA,保留 RSA 链能显著减少握手失败。注意两组证书的中间证书都要完整拼进各自的 fullchain 文件。
# Nginx 1.24.x 双证书配置(TLSv1.2/1.3 为 1.23.4 起的默认值,此处显式声明便于审计)
server {
listen 443 ssl;
server_name www.example.com; # 必须落在证书 SAN 内
ssl_certificate /etc/nginx/ssl/fullchain.rsa.pem; # 站点证书 + 中间证书
ssl_certificate_key /etc/nginx/ssl/privkey.rsa.pem;
ssl_certificate /etc/nginx/ssl/fullchain.ecdsa.pem; # ECDSA P-256 优先
ssl_certificate_key /etc/nginx/ssl/privkey.ecdsa.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_prefer_server_ciphers off; # 让客户端选更优的 cipher suite
}
成本核算别只看证书标价:Let’s Encrypt 是 0 元但 90 天一签,必须把 ACME 自动化(certbot 或 acme.sh 的 --deploy-hook 重载 Nginx)算进方案,否则到期当天微信里就是一片证书过期;商业证书通常 1 年一签,续期验证与人工部署同样计入总成本。据 Mozilla 服务器端 TLS 建议,现代配置应默认启用 TLS 1.2/1.3 并下发完整链——这条对微信内置浏览器同样成立。
微信里常见的真实报错有哪些?逐条排查
微信内置浏览器的报错文案不是自己编的:Android 端(X5 内核 / 系统 WebView)基本原样透传 Chromium 的 net::ERR_CERT_*,iOS 端则透传 WKWebView 背后的系统 TLS 栈提示。所以先认准报错原文,就能把排查范围从”证书全链路”缩到某一环。下表是最常见的六种,右侧一列是可以直接粘贴执行的定位命令。
| 报错原文 | 底层错误码 | 典型根因 | 定位命令 |
|---|---|---|---|
| 该网站的安全证书有问题,请谨慎访问 / iOS「此服务器的证书无效」 | NET::ERR_CERT_INVALID 等泛化错误 | 证书链不完整(缺中间证书) | openssl s_client -showcerts |
| NET::ERR_CERT_AUTHORITY_INVALID | 证书颁发机构不受信任 | 自签、私有 CA、根证书过期 | openssl s_client 看 issuer |
| ERR_CERT_COMMON_NAME_INVALID | 名称不匹配 | SAN 不含当前域名(www / 裸域 / CDN 回源) | openssl x509 -ext subjectAltName |
| certificate has expired / is not yet valid | 有效期校验失败 | 证书过期或服务器时钟偏差 | date -u |
| SSL handshake failed / ERR_SSL_PROTOCOL_ERROR | 握手阶段失败 | 只开 TLSv1.0/1.1、套件被拒、443 被 CDN 终止 | nmap --script ssl-enum-ciphers |
| self-signed certificate in certificate chain | 链中混入自签根 | fullchain 里多打包了根证书 | awk 统计证书数量 |
第一步永远是看 Verify return code。泛化报错没有信息量,握手结果才有:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -E "Verify return code|^ *[0-9]+ s:|i:"
# 必须带 -servername,否则 SNI 未发送,会拿到默认站点证书,误判为名称不匹配
# Verify return code: 0 (ok) → 链完整,问题在应用层(如 CDN 回源)
# Verify return code: 21 (unable to get local issuer certificate) → 缺中间证书
# Verify return code: 10 (certificate has expired) → 过期
返回 21 是最高频的一类。按 RFC 5280 第 6 节的路径构建规则,服务端应下发「站点证书 + 中间证书」,根证书由客户端本地信任库提供——多打包根证书反而会在部分 Android 版本上触发 self-signed certificate in certificate chain。用 awk 数一下 fullchain.pem 里到底塞了几张:
awk 'BEGIN{c=0}/BEGIN CERTIFICATE/{c++}END{print "证书张数:",c}' /etc/nginx/ssl/fullchain.pem
# 正常为 2(站点证书 + 中间证书),3 及以上多半混入了根证书
# 修正 ssl_certificate 指向的文件后:
nginx -t && systemctl reload nginx # nginx -t 通过再 reload,避免中断
ERR_CERT_COMMON_NAME_INVALID 要查 SAN 而不是 CN。自 Chrome 58 起 CN 已被忽略,只认 SAN 扩展(见 RFC 6125 与 CA/Browser Forum 基线要求)。最典型的场景是访问 www.example.com 但证书只签了裸域,或 CDN 回源时源站证书写的是内网域名:
openssl x509 -in /etc/nginx/ssl/cert.pem -noout -ext subjectAltName -dates
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:*.example.com
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=May 30 23:59:59 2026 GMT
日期类报错先怀疑本机时钟。TLS 校验是纯 UTC 比较,服务器偏差超过 300 秒就足以让一张刚签发的证书”尚未生效”:
date -u # 与真实 UTC 对比,偏差 >300 秒立即校时
timedatectl set-ntp true # systemd 系统启用 NTP
chronyc tracking # 确认已同步:Leap status 应为 Normal
systemctl reload nginx # 校时后重载,避免沿用旧会话
握手失败与证书无关,是协议层问题。微信 iOS 端要求 TLS 1.2 起步,若源站只开 TLSv1.0/1.1 或仅留已被弃用的 RSA 套件,握手会在 ServerHello 前就断掉:
nmap --script ssl-enum-ciphers -p 443 example.com
# 输出中 TLSv1.0 / TLSv1.1 应显示 disabled;TLSv1.2、TLSv1.3 需为 offered
# 若 443 上根本不是你的 Nginx(被 CDN/WAF 终止),这里看到的是边缘节点套件
关于旧 Android 对 Let’s Encrypt 的兼容性:Android 7.1 及更早版本不信任 ISRG Root X1,据 Let’s Encrypt 官方公告,DST Root CA X3 于 2021-09-30 过期后靠交叉签名续命,而自 2024-06-06 起默认链已不再包含交叉签名。仍在服务老机型的站点,应改用商业 CA 或显式部署含交叉签名的链,而不是在客户端教用户”点继续访问”。
修复后怎么验证微信不再报证书错误?
修复部署完成后,”能打开”不等于”修好了”。微信内置 X5 内核(Android)与 WKWebView(iOS)对证书链的要求比桌面浏览器更严,必须用命令行 + 在线扫描 + 真机三层验证,缺一层都可能在上线后才暴露问题。
第一步:用 curl 验证协议与证书校验结果
指定 --resolve 可以绕过本地 DNS,直接验证目标 IP 上的证书是否正确,避免”改了解析但本地缓存没生效”的误判。据 curl 官方文档,--resolve 的格式为 HOST:PORT:ADDRESS,优先于 DNS 解析。
# -v 输出握手细节,-I 只取响应头;--resolve 强制指向新服务器 IP
curl -vI https://www.example.com --tlsv1.2 --resolve www.example.com:443:1.2.3.4 2>&1
| grep -E "SSL certificate verify ok|HTTP/2 200|subject:|issuer:"
# 再用 TLS 1.3 测一次,确认新旧协议都能握手(OpenSSL 1.1.1+ / curl 7.52+ 支持)
curl -vI https://www.example.com --tlsv1.3 --resolve www.example.com:443:1.2.3.4 2>&1
| grep -E "SSL connection using|HTTP/2 200"
期望看到 SSL certificate verify ok. 与 < HTTP/2 200;若出现 SSL certificate problem: unable to get local issuer certificate,说明服务端未下发中间证书,这正是微信报错的典型根因。
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- Wildcard 通配符 SSL 证书安装部署续费申请
第二步:OpenSSL 严格校验链完整性
-verify_return_error 让校验失败时直接中断而非仅打印警告,-servername 触发 SNI(多域名共用 IP 时必需)。
openssl s_client -connect www.example.com:443
-servername www.example.com
-verify_return_error
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>&1
| grep -E "Verify return code|Verification|Protocol|Cipher"
必须出现 Verify return code: 0 (ok)。Debian/Ubuntu 的 CA 包路径为 /etc/ssl/certs/ca-certificates.crt,RHEL/CentOS 为 /etc/pki/tls/certs/ca-bundle.crt,macOS 可用 /etc/ssl/cert.pem。若返回 21 (unable to verify the first certificate),即链不完整;10 (certificate has expired) 则是续期后未 reload。
第三步:在线扫描与真机对照
SSL Labs(Qualys SSL Server Test)目标为 A 级,重点看三项:Certificate Chain 是否 “Extra download”(有缺失中间证书)、Protocols 是否仍开放 TLS 1.0/1.1、OCSP Stapling 是否 Yes。需注意:微信并不读取 SSL Labs 评分,该扫描的价值在于独立验证链完整性与 TLS 兼容性。
| 验证手段 | 能发现的问题 | 发现不了的问题 |
|---|---|---|
| curl / OpenSSL | 链缺失、过期、协议不匹配、SNI 错误 | 客户端缓存、CDN 节点差异 |
| SSL Labs | 链顺序、弱协议、OCSP、HSTS | 微信内具体报错文案 |
| 微信真机 | X5/WKWebView 特有拦截、缓存 | 根因定位(需回看前两步) |
真机验证:iOS 微信 8.0.x 与 Android 微信 8.0.x 各一台,微信内打开 https://www.example.com,Wi-Fi 与 4G 各测一次,并上滑杀掉微信后台进程重进(否则复用旧 TLS 会话)。仍报错时,用同一台机的 Safari / Chrome 打开对比:系统浏览器正常而微信异常,多半是 X5 内核缓存或客户端时间偏差。
第四步:DNS 与缓存确认
# 确认 CNAME 已指向新 CDN,并观察各公共 DNS 的解析一致性
dig +short www.example.com CNAME
dig @8.8.8.8 +short www.example.com
dig @223.5.5.5 +short www.example.com # 阿里 DNS,国内微信用户常用
TTL 建议 600 秒以内,切换后 10 分钟内全网基本收敛。清理微信存储(我 → 设置 → 通用 → 存储空间)或换账号登录只能辅助判断是否为客户端缓存,不能替代服务端修复——据 Let’s Encrypt 文档,证书链配置错误必须在服务端补齐中间证书。
第五步:持续监控,别等下次过期
# 每 5 分钟检查剩余有效期,<30 天返回非 0 触发告警
#!/bin/sh
END=$(openssl s_client -connect www.example.com:443 -servername www.example.com
</dev/null 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ "$LEFT" -lt 30 ] && echo "WARN: cert expires in ${LEFT}d" && exit 1
Prometheus 场景用 blackbox_exporter,tls_config.insecure_skip_verify 必须为 false(默认即 false),否则监控永远绿灯;配合 probe_ssl_earliest_cert_expiry 指标设 < time() + 30*86400 告警。续期后务必 nginx -t && nginx -s reload,未 reload 是”证书明明续了微信还报错”的最常见原因。
和微信证书错误相关的 TLS 概念还有哪些?
同一台 Nginx 上挂了十几个域名,为什么微信只对其中一个报“证书无效”?
十有八九是 SNI(Server Name Indication,RFC 6066)没对上。TLS 握手时客户端在 ClientHello 里带上目标域名,Nginx 才能用 server_name 挑出对应证书;若客户端不发 SNI(或发错),服务器会退回 default_server 的证书,微信内置浏览器随即报“该网站的安全证书不受信任”或“证书域名不匹配”。先复现两种行为:
# 带 SNI:模拟微信/浏览器的真实握手,应返回 m.example.com 自己的证书
openssl s_client -connect m.example.com:443 -servername m.example.com /dev/null
| openssl x509 -noout -subject -ext subjectAltName
# 不带 SNI:看服务器回落到了哪张证书(常见是第一个 server 块或 default_server)
openssl s_client -connect m.example.com:443 /dev/null
| openssl x509 -noout -subject
# 命令行侧的典型报错(与微信提示同源)
# curl: (51) SSL: no alternative certificate subject name matches target host name 'm.example.com'
-servername 自 OpenSSL 1.1.1 起稳定可用,不加则等价于“无 SNI 的老客户端”。给兜底站点单独建一个 server 块,可以避免把主站证书错误地暴露出去:
server {
listen 443 ssl default_server; # 捕获所有未匹配 SNI 的连接
server_name _;
ssl_certificate /etc/nginx/ssl/default.pem; # 与任何业务域名都不重叠
ssl_certificate_key /etc/nginx/ssl/default.key;
return 444; # 直接断连,比返回错证书更不容易被误判
}
HSTS 现在能开吗?
HSTS(RFC 6797)本质是“让浏览器以后只走 HTTPS”,Nginx 默认不发送该响应头,需手动加:
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
# max-age 单位秒,31536000 = 1 年;always 保证 4xx/5xx 响应也带(Nginx 1.7.5+)
风险在于不可逆:一旦下发,在 max-age 到期前浏览器不会回退 HTTP,若站内还有 http:// 图片、接口或子域未上证书,就会直接白屏。稳妥做法是先设 max-age=300 观察一周,再逐级放大;includeSubDomains 要等所有子域都上了证书再加。微信 Android 端走系统 WebView、iOS 端走 WKWebView,都继承系统级 HSTS 策略,因此测试时清缓存并不能立刻撤销,只能等 max-age 到期或用 max-age=0 覆盖。
OCSP Stapling 还值得配吗?
它把吊销状态查询搬到服务端缓存,客户端握手时直接拿到签名过的 OCSP 响应,省一次外部请求也少泄露隐私。Nginx 默认 ssl_stapling off:
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 必须含中间证书与根证书
resolver 223.5.5.5 1.1.1.1 valid=300s;
resolver_timeout 5s;
# 验证:期望看到 OCSP Response Status: successful (0x0)
openssl s_client -connect m.example.com:443 -servername m.example.com -status /dev/null
| grep -E "OCSP Response Status|OCSP response"
注意:据 Let’s Encrypt 官方公告,其已于 2025 年 5 月 30 日停止 OCSP 响应服务,新签发证书不再包含 OCSP URL,此时 ssl_stapling on 只会得到 OCSP response: no response sent,属正常现象,吊销状态改由 CRL 承担。商业 CA 证书仍值得开启。
TLS 1.3 和 0-RTT 会影响微信兼容性吗?
基本不会。Nginx 1.13.0 起配合 OpenSSL 1.1.1+/3.x 即支持 TLS 1.3(RFC 8446),主流发行版的 Nginx 1.24 + OpenSSL 3.0 默认具备。建议显式声明协议版本,因为 ssl_protocols 的默认值随版本变化(旧版本为 TLSv1 TLSv1.1 TLSv1.2),不要依赖默认:
ssl_protocols TLSv1.2 TLSv1.3; # 显式写死,避免默认值把 TLSv1/1.1 带回来
ssl_early_data off; # 默认 off;0-RTT 存在重放风险,开启需应用层幂等保护
验证命令:openssl s_client -connect m.example.com:443 -tls1_3 -servername m.example.com,输出里应出现 Protocol : TLSv1.3 与 Cipher : TLS_AES_128_GCM_SHA256。若启用 0-RTT,还需 proxy_set_header Early-Data $ssl_early_data; 让后端识别并拒绝非幂等重放。
要不要上 ECDSA + RSA 双证书?
Nginx 1.11.0 起允许同一 server 块配置多张证书,按客户端能力自动协商;把 ECDSA 写在前面即可优先服务现代客户端,同时用 RSA 兜住老设备(旧 Android WebView 对 ECDSA 链支持不完整,握手会直接失败)。两组 ssl_certificate 都必须带完整中间证书,缺一段就会在微信里表现为“证书链不完整”。
ssl_certificate /etc/nginx/ssl/m.ecdsa.fullchain.pem; # 首选 P-256
ssl_certificate_key /etc/nginx/ssl/m.ecdsa.key;
ssl_certificate /etc/nginx/ssl/m.rsa.fullchain.pem; # 兜底 RSA 2048
ssl_certificate_key /etc/nginx/ssl/m.rsa.key;
| 维度 | RSA 2048 | ECDSA P-256 |
|---|---|---|
| 典型证书链大小 | 约 1.5–2 KB | 约 0.8–1 KB |
| 握手 CPU 开销 | 较高 | 约为 RSA 的十分之一量级 |
| 兼容性 | 全平台 | Android 4.x 及更早 WebView 可能失败 |
| Let’s Encrypt 签发 | 默认类型 | 需 --key-type ecdsa |
| Nginx 配置位置 | 第二条 ssl_certificate |
第一条 ssl_certificate |
验证是否真的选中了 ECDSA:openssl s_client -connect m.example.com:443 -servername m.example.com -sigalgs ECDSA+SHA256,看 Peer signature type。
CT 日志和“私有 CA”有什么关系?
证书透明度(RFC 6962)要求 CA 把证书提交到公开日志,浏览器据此发现误签。Let’s Encrypt 与主流商业 CA 默认提交并随证书下发 SCT;而自建私有 CA 签出的证书不进 CT 日志,也不在微信信任的系统根列表里,所以内网测试站一上公网、用微信一打开就报“证书颁发机构不受信任”。这类场景只能换成公有 CA 证书,或让终端手动安装根证书(微信内通常不生效)。想确认证书有没有 SCT,可执行 openssl s_client -connect m.example.com:443 -servername m.example.com -showcerts /dev/null | openssl x509 -noout -text | grep -A2 "Signed Certificate Timestamp"。
桌面浏览器可能缓存了中间证书或通过 AIA 拉取成功,微信内置浏览器更依赖服务端完整下发证书链。先执行 openssl s_client -showcerts 看是否只返回叶证书,补 fullchain.pem 后重载 Nginx 再测。
没有直接关系;微信按 TLS 链、域名、时间校验证书,DV、OV、EV 都要求链完整。OV/EV 主要影响企业身份审核和展示,不改变微信对证书信任的判断。
可以,前提是 fullchain.pem 完整、域名匹配、未过期。旧 Android 7 以下可能不信任 ISRG Root X1,需要交叉链或换根;90 天续期要用 certbot renew –dry-run 和定时器自动化。
说明服务端未发送中间证书或链顺序错误。把 intermediate.crt 与叶证书合并为 fullchain.pem,Nginx 的 ssl_certificate 指向 fullchain,执行 nginx -t && systemctl reload nginx 后复测。
少数旧证书缓存场景可临时缓解,但根因通常在服务端链、域名或时间。清微信存储后仍报错,应按 openssl s_client 输出排查,不能把清缓存当修复方案。
要;CDN 回源若走 HTTPS,源站证书也要被 CDN 校验,回源域名与证书 SAN 要匹配。检查 CDN 控制台回源协议、回源端口 443、SNI 和回源证书链。
小程序请求域名需在后台配置合法域名,证书需受信任且 TLS 1.2 及以上;公众号网页在微信内置浏览器打开,同样校验证书链、域名和时间,但小程序不跟随网页重定向到未配置域名。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。