SSL 证书全链路信任实战:浏览器、Android、iOS ATS 与微信小程序兼容指南
问题背景与根因:证书装了,为什么访客仍然看到“不安全”
原文用“熟人开店”的比喻讲信任:老顾客认识你,陌生访客不认识你,需要一个中立的第三方证明“这家店确实是它自称的那家”。在 HTTPS 里,这个第三方就是 CA(证书颁发机构),而证明过程是一条链:服务器证书(叶子)→ 中间证书 → 根证书,根证书预置在客户端的信任库里。链上任何一环断了,浏览器、Android、iOS 或微信就会报错,哪怕你在服务器上“明明已经装了证书”。
实际运维中,绝大多数“证书已安装但不被信任”都能归到下面四类根因:
- 证书链不完整:只部署了叶子证书,没带中间证书。桌面 Chrome 可能通过 AIA(Authority Information Access)自动补链,但 Android、微信小程序、Java 客户端不会,于是出现“电脑打开正常、手机报错”的经典现象。
- 域名不匹配:Chrome 58 之后只认 SAN(subjectAltName),不再回退到 CN。证书只写了 example.com,访问 www.example.com 必然失败。
- 证书过期或服务器时间漂移:有效期已过,或者服务器时钟跑到证书 notBefore 之前。
- 信任库差异:自签证书、私有 CA;Android 7.0 起应用默认不信任用户手动安装的 CA;Let’s Encrypt 自 2024 年 9 月起不再提供交叉签名链,Android 7.1.1 以下的老设备不再信任 ISRG Root X1。
先做一次体检,确认链是否完整:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl crl2pkcs7 -nocrl -certfile /dev/stdin
| openssl pkcs7 -print_certs -noout
正常输出应包含至少两张证书:subject=CN = example.com 和 subject=C = US, O = Let's Encrypt, CN = R11(或你所购 CA 的中间证书)。只输出一张,就是缺中间证书。
还有一条必须记住的时间线:CA/Browser Forum 规定,2020-09-01 起签发的公开信任 TLS 证书有效期上限为 398 天;Let’s Encrypt 更短,只有 90 天。这意味着手工续期不可行,必须自动化,否则迟早踩到过期这个坑。
实操第一步:生成私钥与带 SAN 的 CSR
不要用在线工具生成私钥,也不要把私钥明文打包进代码仓库。以下命令在 OpenSSL 1.1.1+ 上可直接执行(-addext 是 1.1.1 引入的):
mkdir -p /etc/ssl/example.com && cd /etc/ssl/example.com
umask 077
# 1) RSA 2048 私钥,兼容性最好
openssl genrsa -out example.com.key 2048
# 2) 生成 CSR,必须用 -addext 写入 SAN
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co.,Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"
# 3) 校验证书请求内容
openssl req -in example.com.csr -noout -verify
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
输出应类似 DNS:example.com, DNS:www.example.com, DNS:api.example.com。如果只看到 CN=example.com 而没有 SAN 行,说明扩展没写进去,签出来的证书在 Chrome 和微信里都会被判为域名不匹配。
如果客户端环境较新(Nginx 1.11.0+、Android 5.0+、iOS 9+),推荐改用 ECC 证书,握手更快、报文更小:
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr
-subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
CSR 里只有公钥和主体信息,私钥永远不离开本机,CA 无法从 CSR 反推私钥。提交时注意两点:一是 SAN 列表要与 DNS 解析完全一致,www 与非 www 是两个域名,多数 CA 不默认赠送;二是通配符 *.example.com 只匹配一级子域,不匹配 a.b.example.com,也不匹配裸域 example.com。
内网联调可以用自签证书,但要清楚:自签证书在公网浏览器、iOS ATS、微信小程序里一律不被信任。
openssl req -x509 -new -key example.com.key -days 365 -out self.crt
-subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:localhost"
实操第二步:签发、合并证书链并部署到 Nginx
生产环境优先用 ACME 自动签发。以 acme.sh 的 webroot 模式为例,签发过程不中断服务:
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com
--webroot /var/www/html
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/ssl/example.com/example.com.key
--fullchain-file /etc/ssl/example.com/fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
acme.sh 会写入 cron 自动续期(Let’s Encrypt 有效期 90 天,默认在到期前 30 天续签)。如果买的是商业证书,CA 通常给你两个文件:example.com.crt(叶子)和 ca_bundle.crt(中间证书)。服务器上必须合并成一个文件,顺序是叶子在前、中间在后:
cat example.com.crt ca_bundle.crt > fullchain.pem
# 不要放根证书:体积大且无意义,部分老客户端还会因此报错
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
最后一行输出 fullchain.pem: OK 才算链正确;输出 unable to get local issuer certificate 说明中间证书缺失或顺序反了。
文件权限与布局建议如下,私钥 600、属主 root:
chmod 600 /etc/ssl/example.com/example.com.key
chmod 644 /etc/ssl/example.com/fullchain.pem
ls -l /etc/ssl/example.com/
还有两个容易忽略的点。第一,证书必须是 PEM 格式(以 -----BEGIN CERTIFICATE----- 开头),从 Windows 导出的 .pfx/.p12 需要转换:openssl pkcs12 -in cert.pfx -nokeys -out fullchain.pem。第二,同一 IP 上跑多个站点时依赖 SNI,每个 server 块都要配置自己的 ssl_certificate,否则会拿默认证书响应,客户端看到的就是“证书域名不符”。部署完先做语法检查再 reload,避免把线上打挂:
nginx -t && nginx -s reload
systemctl status nginx --no-pager
配置示例:TLS 参数、HSTS 与 OCSP Stapling 完整片段
下面是一份可直接粘贴的 Nginx 配置(Nginx 1.25.1+ 用 http2 on;,更早版本写成 listen 443 ssl http2;):
server {
listen 443 ssl;
http2 on;
server_name example.com www.example.com;
ssl_certificate /etc/ssl/example.com/fullchain.pem;
ssl_certificate_key /etc/ssl/example.com/example.com.key;
ssl_trusted_certificate /etc/ssl/example.com/chain.pem;
ssl_protocols 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;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 1.1.1.1 valid=300s;
resolver_timeout 5s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
location / { proxy_pass http://127.0.0.1:8080; }
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
逐项说明几个关键点:
ssl_trusted_certificate指向中间证书链(不含叶子),供 OCSP Stapling 校验使用,不要和ssl_certificate混用同一个文件。ssl_stapling让服务器在握手中直接返回 OCSP 响应,省掉客户端访问 CA 的一次 RTT;必须配resolver,缺了它 stapling 会静默失效。- 只开 TLSv1.2 与 TLSv1.3:Chrome 98+、新版微信、iOS ATS 都满足;保留 TLSv1.0/1.1 会同时触发 PCI DSS 不合规与 iOS ATS 拒绝。
- HSTS 首次上线建议先用
max-age=300观察一周,再逐步放大到 31536000;includeSubDomains一旦下发无法撤回,若有只支持 HTTP 的子域会直接不可访问。
验证配置是否真的生效:
nginx -t
curl -sI https://example.com | grep -i strict-transport-security
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -i "OCSP Response Status"
应分别看到 strict-transport-security: max-age=31536000 与 OCSP Response Status: successful (0x0)。
平台差异对比:浏览器、Android、iOS ATS、微信小程序
同一张证书在不同客户端表现不同,是因为各家信任库、链构建策略与策略约束不一样。下表是当前仍然有效的关键差异:
| 客户端/平台 | 信任库来源 | 最低 TLS | 证书链要求 | 有效期上限 | 关键限制 |
|---|---|---|---|---|---|
| Chrome / Edge | 操作系统根库 | TLS 1.2 | 可 AIA 自动补链,容错较高 | 398 天 | 只认 SAN;HTTP 页面标记“不安全” |
| Firefox | NSS 自带根库 | TLS 1.2 | 可 AIA 补链 | 398 天 | 独立信任库,私有 CA 需单独导入 |
| iOS / macOS(ATS) | 系统根库 | TLS 1.2 | 必须完整,不依赖 AIA | 398 天 | 签名算法 SHA-256 及以上;RSA≥2048 或 ECC≥256;要求 ECDHE 前向保密;HTTP 明文默认禁止 |
| Android 7.1.1+ | 系统 CA | TLS 1.2 | 必须完整,不抓 AIA | 398 天 | 7.0+ 应用默认不信任用户安装的 CA |
| Android 7.0 及以下 | 系统 CA | TLS 1.2 | 必须完整 | 398 天 | 需交叉签名根;Let’s Encrypt 自 2024-09 起不再提供,老设备会失败 |
| 微信小程序 | 系统网络栈 | TLS 1.2 | 必须完整 | 398 天 | 不支持自签与 IP 直连;域名需备案且与证书完全一致 |
| Java 客户端(PKIX) | JDK cacerts | TLS 1.2 | 必须完整 | — | JDK 8u181 之前对 Let’s Encrypt 兼容有问题,需升级或手工导入 ISRG Root X1 |
从表里能读出三条实用结论。第一,证书链完整性是唯一所有平台都强制的项,只要部署的是 fullchain,就能同时解决 Android、微信、Java 的绝大多数报错。第二,iOS ATS 是最严格的一档:它不只校验证书,还要求 TLS 1.2+、SHA-256 签名、ECDHE 密钥交换;如果后端是老旧 Tomcat 或自研网关,经常是证书没问题但套件不达标。第三,微信小程序与 ATS 都要求域名与证书一致,用 IP 直连、或用 api.example.com 的证书去服务 example.com 的请求,都会直接被拒。
常见错误排查:从 ERR_CERT_* 到 request:fail
下面按出现频率排列,每条都给出真实报错原文与对应处理动作。
- 缺中间证书:浏览器
NET::ERR_CERT_AUTHORITY_INVALID,命令行curl: (60) SSL certificate problem: unable to get local issuer certificate,AndroidTrust anchor for certification path not found.。处理:cat example.com.crt ca_bundle.crt > fullchain.pem后 reload,再用openssl verify确认返回 OK。 - 域名不匹配:
NET::ERR_CERT_COMMON_NAME_INVALID。处理:openssl x509 -in fullchain.pem -noout -ext subjectAltName核对 SAN;缺少的域名只能重新签发,无法事后补加。 - 证书过期或时钟漂移:
NET::ERR_CERT_DATE_INVALID、curl: (60) SSL certificate problem: certificate has expired。处理:date -u检查服务器时间,openssl x509 -in fullchain.pem -noout -dates检查有效期,然后续期并 reload。 - iOS ATS 拦截:
NSURLErrorServerCertificateUntrusted (-1202),或App Transport Security has blocked a cleartext HTTP (http://) resource load since it is insecure。前者是链或套件不达标,后者是接口还在走明文 HTTP,需改 HTTPS 或在 Info.plist 中做最小范围例外。 - 微信小程序:
request:fail ssl hand shake error。依次排查 TLS 版本是否 ≥1.2、链是否完整、请求域名与证书 SAN 是否一致;真机打开调试模式可看到更详细的底层错误。 - Java 服务端调用:
javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。处理:补齐服务端证书链,或keytool -importcert -alias example -file root.crt -keystore $JAVA_HOME/lib/security/cacerts导入根证书。
排查顺序建议固定为:链 → 域名 → 有效期 → 协议与套件 → 客户端策略。按这个顺序走,一次 openssl s_client 基本就能定位到具体环节。
效果验证:五条命令确认全链路可信
改完配置不要只看浏览器地址栏的小锁,用命令做客观验证:
# 1) 握手与链完整性
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "s:|i:|Verify return code"
# 2) 主体、签发者、有效期与 SAN
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 3) 剩余天数告警(1296000 秒 = 15 天)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -checkend 1296000 && echo "OK: 剩余超过 15 天" || echo "WARN: 需立即续期"
# 4) 协议与验证结果
curl -sS -o /dev/null -w "%{http_code} verify=%{ssl_verify_result} handshake=%{time_appconnect}sn" https://example.com
curl --tlsv1.2 --tls-max 1.2 -sS -o /dev/null -w "TLS1.2: %{http_code}n" https://example.com
curl --tlsv1.3 -sS -o /dev/null -w "TLS1.3: %{http_code}n" https://example.com
# 5) 第三方评级
docker run --rm -ti drwetter/testssl.sh --severity HIGH https://example.com
判读标准:Verify return code: 0 (ok) 表示链完整且可验证;ssl_verify_result 为 0 表示 curl 侧校验通过;两条 curl 都返回 200,说明 TLS 1.2 与 1.3 均可正常协商。testssl.sh 或 SSL Labs 报告中重点看 “Chain of trust” 是否为 “Pass”,以及 “Certificate expiration” 是否在 398 天规则内。
最后做一轮真实客户端抽查:用一台 Android 7.1 以下的旧机、一台 iOS 15+ 真机、以及关闭“不校验合法域名”的微信开发者工具各访问一次。开发者工具能通、真机不通,基本就是证书链问题;iOS 通、旧 Android 不通,多半是根证书兼容问题。
常见问题
证书装好后电脑正常、手机报错,是什么原因?
绝大多数是证书链不完整。桌面浏览器会通过证书里的 AIA 字段自动下载中间证书补齐,而 Android、微信小程序、Java 不会。用 openssl s_client -showcerts 确认服务器是否返回了两张以上证书,没有就合并 fullchain 后 reload。
Let’s Encrypt 的免费证书能用在 iOS ATS 和微信小程序上吗?
可以。只要证书链完整、域名匹配、有效期在 398 天以内(Let’s Encrypt 是 90 天),ATS 与微信小程序都接受。唯一的历史坑是 Android 7.1.1 以下老设备:Let’s Encrypt 自 2024 年 9 月起不再提供交叉签名链,这类设备会提示信任锚缺失,需要通过应用内自带信任库或升级系统解决。
398 天这个上限是怎么来的,能签更长的吗?
来自 CA/Browser Forum 的基线要求:2020-09-01 起签发的公开信任 TLS 服务器证书有效期不得超过 398 天,苹果和 Chrome 会直接拒绝超期证书。公有 CA 无法绕过,只能靠自动化续期;私有 CA 签发的内网证书不受此限制,但需要在客户端手动导入根证书。
DV、OV、EV 证书在技术上有什么区别?
加密强度没有区别,都能提供同等 TLS 保护。区别在身份校验深度:DV 只验证域名控制权,签发最快;OV 验证企业主体信息;EV 校验最严格。浏览器已不再为 EV 证书显示特殊标识,因此面向公众的站点选 DV 加自动化续期即可,企业门户、支付类业务可按合规要求选择 OV。
通配符证书能覆盖多级子域吗?
不能。*.example.com 只匹配一级子域,如 api.example.com,不匹配 a.b.example.com,也不匹配裸域 example.com。要同时覆盖裸域和多级子域,需要在 SAN 中显式列出,例如 example.com + *.example.com + *.api.example.com。
HSTS 配错了怎么回滚?
HSTS 一旦下发,在 max-age 到期前浏览器会强制 HTTPS,服务器端无法撤销。所以首次上线务必先用 max-age=300 试运行,确认所有子域都有 HTTPS 服务后再逐步加大;不要一开始就带 includeSubDomains 和 preload。如果已经误配,只能保证对应域名的 443 端口持续可用,等待 max-age 自然过期。