HTTPS 部署与 SSL 证书配置完整指南:兼容微信小程序、苹果 ATS 与支付宝(含 398 天有效期新规)
一、问题背景与根因:HTTP 站点在微信、苹果、支付宝上为什么“过不去”
把一个站点从 HTTP 切到 HTTPS,今天已经不只是 SEO 加分项,而是硬门槛。Chrome 68 起对 HTTP 页面地址栏直接标“不安全”;百度、Google 明确优先抓取和展现 HTTPS 结果;微信小程序 wx.request 只允许 https:// 域名,且要求 TLS 1.2 及以上、证书由受信任 CA 签发、证书链完整、域名已备案,IP 地址和自签名证书一律拒绝;苹果 ATS(App Transport Security,iOS 9 起默认开启)要求 TLS 1.2、支持前向保密的 ECDHE 套件、SHA-256 及以上签名、RSA 至少 2048 位或 ECC 至少 256 位;支付宝的网页支付、APP 支付异步通知同样要求回调地址为 HTTPS。
但实践中“装了证书还是报错”的情况占多数,根因集中在三点:
① 只部署了服务器证书(leaf certificate),漏掉中间证书(intermediate CA)。桌面 Chrome 会通过 AIA 自动补链,看起来一切正常;微信内置浏览器、老版本 Android、Java 客户端不会补链,于是报 unable to get local issuer certificate。
② 协议与套件太旧。不少老服务器仍开着 TLS 1.0/1.1,或套件里带 RC4、3DES、CBC 模式,苹果 ATS 与微信会直接握手失败。
③ 证书 SAN 字段与实际访问域名不一致。给 example.com 签的证书去访问 www.example.com 会报 ERR_CERT_COMMON_NAME_INVALID;通配符 *.example.com 也只覆盖一级子域。
所以“兼容微信、苹果、支付宝”的本质不是买更贵的证书,而是:完整证书链 + TLS 1.2/1.3 + 域名匹配 + 页面无混合内容。下面按可执行步骤逐条落地。
二、证书选型:DV/OV/EV、通配符与 398 天有效期新规
选证书先看验证级别和覆盖范围。DV(Domain Validation)只验证域名控制权,通常分钟级签发,适合个人站与 API;OV(Organization Validation)需提交营业执照并人工审核 1-3 个工作日;EV(Extended Validation)审核更严。需要注意:Chrome 77 起已移除 EV 证书地址栏的绿色公司名展示,只为“绿条”买 EV 已无意义。
有效期规则必须更新:按 CA/Browser Forum 基线要求,2020 年 9 月 1 日起签发的公开信任 TLS 证书最长有效期为 398 天(此前为 825 天),因此“买三年、一次部署”的方案早已不成立;Let’s Encrypt 免费证书有效期为 90 天,官方推荐用 ACME 客户端自动续期。选型时还要确认:私钥算法 RSA 2048 位或 ECC P-256;签名算法 SHA-256 及以上;证书必须带 SAN 扩展(现代浏览器已不看 CN 字段)。
覆盖范围:单域名证书只保护一个 FQDN;多域名(SAN/UCC)可放数十个域名;通配符 *.example.com 只匹配一级子域(a.example.com 可以,a.b.example.com 不行),且不覆盖裸域 example.com,实际常用“通配符 + 裸域”组合。
成本参考:Let’s Encrypt / ZeroSSL 免费;商业 DV 约几十到几百元/年;OV 千元级;EV 数千元。服务商报的“DV 单域名 120 元/年、安装服务 216 元/年”属于代维服务费,自己用 certbot 部署成本为零,但续期监控责任要自己承担。
三、实操第一步:生成私钥与 CSR(OpenSSL 可直接执行)
CSR(Certificate Signing Request)包含公钥与主体信息,私钥必须留在自己服务器上,绝不能发给 CA 或代维服务商。
# 1. 生成 2048 位 RSA 私钥(生产环境可用 3072 位或 ECC P-256)
openssl genrsa -out example.com.key 2048
chmod 400 example.com.key
# 2. 生成 CSR,务必带 SAN,把所有要用的域名都写进去
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co.,Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com'
# 3. 校验 CSR 内容与私钥是否配对
openssl req -noout -text -in example.com.csr | grep -A1 'Subject Alternative Name'
openssl rsa -noout -modulus -in example.com.key | openssl md5
openssl req -noout -modulus -in example.com.csr | openssl md5 # 两个 md5 必须一致
如果偏好 ECC(握手更快,微信与 iOS 全支持):
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'
常见坑:-subj 中 CN 超过 64 字符会失败;-addext 需要 OpenSSL 1.1.1 及以上,老版本改用 -config openssl.cnf 配合 [v3_req] 段;CSR 里没写 www 却拿它去签,部署后必然域名不匹配。私钥权限设为 400 并做离线备份,丢失只能重签。
四、实操第二步:签发与导入证书(Let’s Encrypt 自动签发 / 商业证书导入)
免费路线用 Certbot,一条命令完成签发、写入 Nginx 配置并加 301 跳转:
apt install -y certbot python3-certbot-nginx
certbot --nginx -d example.com -d www.example.com
--agree-tos -m ops@example.com --redirect --keep-until-expiring
# 无法停 Nginx 时用 webroot 模式
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
证书落在 /etc/letsencrypt/live/example.com/,其中 fullchain.pem = 服务器证书 + 中间证书,privkey.pem 是私钥。续期由 systemd timer 自动完成,必须验证:
systemctl list-timers | grep certbot
certbot renew --dry-run
商业证书从 CA 下载的通常有 example.com.crt(服务器证书)、intermediate.crt(中间证书)、root.crt(根证书,不要拼进链)。拼接顺序是“服务器证书 → 中间证书”:
cat example.com.crt intermediate.crt > fullchain.pem
openssl x509 -in example.com.crt -noout -subject -issuer -dates
openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt
若服务商只给了一个 .pfx(IIS/Tomcat 常见),用 OpenSSL 拆开:
openssl pkcs12 -in cert.pfx -nocerts -nodes -out example.com.key
openssl pkcs12 -in cert.pfx -clcerts -nokeys -out example.com.crt
openssl pkcs12 -in cert.pfx -cacerts -nokeys -out intermediate.crt
因为 398 天上限,任何手工部署方案都必须配到期提醒,否则一年后微信小程序会突然整批 request:fail。
五、配置示例:Nginx / Apache / Tomcat 开启 TLS 1.2+ 与完整证书链
Nginx(1.25 起建议 listen 443 ssl; 与 http2 on; 分开写):
server {
listen 443 ssl;
http2 on;
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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
Apache 2.4:
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/certs/fullchain.pem
SSLCertificateKeyFile /etc/httpd/certs/example.com.key
# Apache 2.4.8 之前必须单独指定中间证书
SSLCertificateChainFile /etc/httpd/certs/intermediate.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
Tomcat:把 pfx 转成 JKS,或在 Connector 里直接指定 PKCS12:
keytool -importkeystore -srckeystore cert.pfx -srcstoretype PKCS12
-destkeystore example.jks -deststoretype JKS
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
SSLEnabled='true' scheme='https' secure='true'
keystoreFile='/opt/tomcat/conf/example.jks' keystorePass='***'
sslEnabledProtocols='TLSv1.2,TLSv1.3' />
最后处理混合内容:页面里写死的 http:// 图片、JS、CSS 会被 Chrome 判为 Mixed Content 并拦截锁标(微信与 iOS 同样失败)。批量排查:
curl -s https://example.com | grep -o 'http://[^ ]*' | sort -u
把结果全部改为 https:// 或协议相对 //,再加 CSP 的 upgrade-insecure-requests 兜底。
六、对比表格:证书类型、部署方式与客户端兼容要求
表 1:证书类型对比
| 类型 | 验证内容 | 签发时长 | 有效期上限 | 价格区间 | 适用场景 |
|---|---|---|---|---|---|
| DV 单域名 | 域名控制权(DNS/HTTP/文件) | 分钟级 | 398 天(LE 为 90 天) | 免费~数百元/年 | 个人站、API、测试环境 |
| OV | 营业执照 + 电话核验 | 1-3 工作日 | 398 天 | 千元/年 | 企业官网、支付回调 |
| EV | 扩展人工审核 | 3-7 工作日 | 398 天 | 数千元/年 | 金融(已不显示绿条) |
| 通配符 DV | 域名控制权 | 分钟级 | 90 / 398 天 | 数百~数千元/年 | 多子域业务 |
| 多域名 SAN | 域名控制权 | 分钟级 | 90 / 398 天 | 按域名数计价 | 多品牌域名 |
表 2:部署方式对比
| 场景 | 证书格式 | 关键点 |
|---|---|---|
| Nginx | fullchain.pem + key | 证书链必须拼接,只放 leaf 会断链 |
| Apache 2.4 | fullchain 或 crt + chain | 2.4.8 之前必须配 SSLCertificateChainFile |
| Tomcat | JKS / PKCS12 | keystore 别名要与域名一致 |
| IIS | pfx | 服务器证书放“个人”,中间证书放“中间证书颁发机构” |
| 云负载均衡 / CDN | PEM 上传 | 回源协议也要用 HTTPS,否则回源段仍是明文 |
| 虚拟主机面板 | 文本粘贴 | 只能贴 fullchain,不能只贴服务器证书 |
表 3:客户端兼容要求
| 客户端 | 最低要求 | 常见不兼容点 |
|---|---|---|
| 微信小程序 | TLS 1.2+、受信任 CA、域名已备案 | 自签名、链不全、IP 访问、TLS 1.0 |
| iOS ATS | TLS 1.2、ECDHE、SHA-256、RSA2048/ECC256 | TLS 1.0、RC4、SHA-1 签名 |
| Android 4.4 | TLS 1.2 需显式开启、需完整链 | 缺中间证书直接握手失败 |
| Chrome / Edge | 受信任 CA、SAN 匹配、无混合内容 | 证书过期、混合内容、HSTS 误配 |
七、常见错误排查:真实报错与逐条修复
下面这些报错在 HTTPS 部署中最常出现,按顺序排查基本能覆盖 95% 的故障:
1. curl: (60) SSL certificate problem: unable to get local issuer certificate —— 服务器没有下发中间证书。修复:Nginx 的 ssl_certificate 指向 fullchain.pem;Apache 补 SSLCertificateChainFile。验证:openssl s_client -connect example.com:443 -showcerts 输出应有 2 张以上证书。
2. 浏览器 NET::ERR_CERT_AUTHORITY_INVALID —— 自签名证书或证书链断裂。用 SSL Labs 查看 “Chain issues” 一栏。
3. NET::ERR_CERT_COMMON_NAME_INVALID —— SAN 不含当前访问域名,重新签发并把 www 或子域补进 SAN。
4. 微信小程序 request:fail ssl handshake error —— 依次检查:TLS 版本是否 ≥1.2(用 openssl s_client -tls1_2 测)、证书链是否完整、是否自签名、域名是否已备案、是否用 IP 访问。
5. iOS NSURLErrorDomain Code=-1200 —— ATS 拒绝握手。在 macOS 上执行 nscurl --ats-diagnostics https://example.com 定位,多数是 TLS 1.0 或 CBC 套件导致。
6. Nginx 启动报 SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) —— 证书与私钥不配对,用前面 CSR 章节的 modulus 比对法确认。
7. Apache 报 AH01909: RSA certificate configured for example.com:443 does NOT include an ID which matches the server name —— ServerName 与证书域名不一致,补 ServerAlias 或换证书。
8. 浏览器 ERR_CERT_DATE_INVALID —— 证书已过期(398 天规则下极易踩坑),续期后执行 nginx -s reload 或 systemctl reload httpd。
9. ERR_SSL_PROTOCOL_ERROR —— 443 端口被 HTTP 服务占用或协议被禁用,用 ss -lntp | grep 443 确认监听进程。
10. 支付宝 / 微信支付异步通知收不到 —— 回调 URL 仍是 http,或 Java 客户端校验证书链失败(缺中间证书),需导入完整链到 truststore。
八、效果验证:openssl、curl、SSL Labs 与三端真机
部署完成后按下面四组命令逐项验证,全部通过才算“兼容微信、苹果、支付宝”:
# 1. 查看证书主体、签发者与有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 2. 统计链上证书数量,正常为 2~3 张,只有 1 张说明缺中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 3. 强制 TLS 1.2 握手(微信 / ATS 兼容性验证)
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
# 4. 校验信任链、跳转与 HSTS
curl -sSI https://example.com | grep -i strict-transport-security
curl -vI https://example.com 2>&1 | grep -i 'SSL certificate verify'
再补三项人工验证:SSL Labs(ssllabs.com/ssltest)评级应达到 A 及以上,重点看 “Certificate Chain Complete” 是否为 Yes;微信先用开发者工具关闭“不校验合法域名”选项,再用真机跑一次 wx.request;苹果在 macOS 上执行 nscurl --ats-diagnostics https://example.com,所有 ATS 测试项均为 PASS 才算通过。
到期监控建议接入自动化:echo | openssl s_client -connect example.com:443 2>/dev/null | openssl x509 -noout -enddate 取到期时间,或使用 Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标,提前 30 天告警;同时保留 certbot renew --dry-run 的定时检查。
常见问题
证书有效期为什么是 398 天,而不是以前的一年或三年?
CA/Browser Forum 基线要求规定,2020 年 9 月 1 日起签发的公开信任 TLS 证书最长有效期为 398 天,目的是缩短私钥泄露与配置错误的暴露窗口。Let’s Encrypt 更短,只有 90 天。结论是必须自动化续期,手工部署一定要配到期监控。
免费的 Let’s Encrypt 证书能用于微信小程序和支付宝吗?
可以。微信和支付宝校验的是“证书是否由受信任 CA 签发 + 链是否完整 + 域名是否匹配 + TLS 版本是否 ≥1.2”,Let’s Encrypt 在主流系统信任库中,满足条件即可。但 90 天有效期必须自动续期,且续期后要 reload 服务让新证书生效。
一张证书能同时给 example.com 和 www.example.com 用吗?
可以,签发时把两个域名都写进 SAN 即可。注意通配符 *.example.com 不包含裸域 example.com,需要“通配符 + 裸域”两张证书,或直接申请一张多域名 SAN 证书。
部署后 Chrome 正常,但微信或老安卓报错,怎么查?
九成是证书链不全。用 openssl s_client -showcerts 看是否返回 2 张以上证书,只有 1 张就说明缺中间证书,把 fullchain 配到服务器即可。其次是 TLS 版本过低,用 -tls1_2 单独测试握手是否成功。
HTTP 自动跳转 HTTPS 会不会影响 SEO?
不会,301 是标准做法,搜索引擎会把权重传递到 HTTPS 版本。建议全站 301、保持 URL 路径不变,并在搜索资源平台重新提交 HTTPS 站点地图。
证书过期忘记续期,站点已经打不开了怎么办?
立即重新签发并 reload 服务:Let’s Encrypt 用 certbot renew --force-renewal 后 nginx -s reload,商业证书重新导入 fullchain。事后补上到期前 30 天告警,或直接改用 ACME 自动续期配合 deploy hook 自动 reload。