跳到主要内容
HTTPS小程序证书

SSL 证书全链路信任实战:浏览器、Android、iOS ATS 与微信小程序兼容指南

SSL 证书全链路信任实战:浏览器、Android、iOS ATS 与微信小程序兼容指南 — 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,Android Trust 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 自然过期。

内容审核

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