SSL证书HTTPS与通配符泛域名实战:微信小程序、iOS ATS配置与排错指南
问题背景与根因:HTTPS、通配符证书与小程序/iOS的硬性要求
原文把SSL证书描述为“1年使用期限”和“小绿锁”,这两点在当前浏览器与CA规则下都已过时。公开信任的TLS证书最长有效期已被限制为398天,Let’s Encrypt免费证书有效期为90天;现代浏览器也不再显示“小绿锁”,而是用锁图标和“连接安全”提示表达HTTPS状态。HTTPS的本质是HTTP over TLS:客户端通过证书链验证服务器身份,再协商TLS 1.2/1.3加密套件。微信小程序要求请求域名使用HTTPS、由受信任CA签发、证书链完整,并配置到request合法域名;iOS的ATS默认要求TLS 1.2及以上、前向保密密码套件和可信证书链。常见根因包括:只部署了叶子证书未部署中间证书、证书SAN不包含实际域名、通配符证书误用于二级子域、TLS 1.0/1.1未关闭、证书过期、微信后台未加入合法域名、iOS例外配置错误。另一个常见误区是“一个IP只能装一个证书”,在SNI普及后Nginx、Apache、IIS 8+均可在同一IP上按域名选择多张证书。排查时应先看证书链和SAN,再看TLS版本与域名配置,最后看小程序/iOS侧限制。
证书选型与有效期事实:DV、OV、EV与通配符边界
选型先看域名结构。单域名证书只保护一个FQDN,例如api.example.com;通配符证书`*.example.com`只保护一级子域,如api.example.com、www.example.com,不保护example.com本身,也不保护a.b.example.com;多域名SAN证书可把example.com、*.example.com、api.example.com放在同一张证书里。微信小程序和iOS并不要求OV/EV,DV证书只要CA受信任、链完整即可。OV/EV增加组织验证,但浏览器已取消EV绿条展示,不能把“绿条”作为选型依据。有效期方面:CA/B论坛规则下公开信任TLS证书最长398天;Let’s Encrypt为90天且支持自动续期;部分商业CA按398天上限签发。原文“1-10元/年、1年期限”的说法不应再作为部署依据,长期方案应自动化续期并监控到期时间。通配符证书建议用DNS-01验证,因为可同时签发`example.com`与`*.example.com`,且不依赖80端口。CSR中必须把根域和通配符都写入SAN,否则微信小程序请求根域或API域名时仍会报域名不匹配。证书私钥建议RSA 2048或ECDSA P-256,避免过短密钥。部署前用`openssl x509 -in cert.pem -noout -text | grep -A1 ‘Subject Alternative Name’`核对SAN,确认包含小程序实际请求的每个域名。
完整实操步骤:CSR生成、DNS-01签发、部署与权限
第一步生成私钥与CSR(OpenSSL 1.1.1+支持-addext):
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example/CN=*.example.com'
-addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
第二步用acme.sh走DNS-01自动签发,以阿里云DNS为例:
curl https://get.acme.sh | sh -s email=admin@example.com
export Ali_Key='你的AccessKeyId'
export Ali_Secret='你的AccessKeySecret'
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength ec-256
dig TXT _acme-challenge.example.com +short
第三步安装证书并设置续期后自动重载:
install -d -m 700 /etc/nginx/ssl
acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd 'systemctl reload nginx'
chmod 600 /etc/nginx/ssl/example.com.key
nginx -t && systemctl reload nginx
注意:`–fullchain-file`必须包含叶子证书和中间证书,微信小程序与iOS对链完整性很敏感;私钥权限设为600;通配符参数`-d ‘*.example.com’`要加引号防止shell展开;DNS TXT记录可能因TTL有10-30分钟缓存,签发失败先查`_acme-challenge`解析。Let’s Encrypt证书90天到期,acme.sh默认自动续期,但仍需用`acme.sh –list`确认下次续期时间。
Nginx与Apache配置示例:TLS 1.2/1.3与完整证书链
Nginx建议使用fullchain,关闭TLS 1.0/1.1,开启会话缓存。Nginx 1.25.1+可用`http2 on;`,旧版可用`listen 443 ssl http2;`:
server {
listen 443 ssl;
http2 on;
server_name example.com *.example.com;
ssl_certificate /etc/nginx/ssl/example.com.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' always;
location / { proxy_pass http://127.0.0.1:8080; }
}
Apache 2.4示例,旧版本需要`SSLCertificateChainFile`,新版本把fullchain写入`SSLCertificateFile`即可:
<VirtualHost *:443>
ServerName example.com
ServerAlias *.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
配置后执行`nginx -t`或`apachectl configtest`,再reload。微信小程序和iOS不要求HSTS,但HSTS可减少降级风险;首次上线建议先用较短max-age测试。若源站前面有CDN/负载均衡,证书要部署在入口层,回源也要HTTPS或至少保证入口证书链完整。注意`server_name`要同时写根域和通配符,否则SNI选错证书会返回默认站点证书。
微信小程序与iOS ATS配置:合法域名、TLS版本与例外策略
微信小程序侧:登录微信公众平台,进入开发管理-开发设置-服务器域名,把`https://api.example.com`加入request合法域名;域名需完成ICP备案,不能使用IP或localhost,建议使用443标准端口,避免多级跳转。小程序请求示例:
wx.request({
url: 'https://api.example.com/v1/user',
method: 'GET',
success(res) { console.log(res.statusCode); }
});
若报`request:fail ssl hand shake error`,优先检查TLS 1.2、证书链、SNI和证书有效期,而不是先改小程序代码。iOS侧:ATS默认要求HTTPS和TLS 1.2+,全站HTTPS时无需在Info.plist添加例外。只有对接历史HTTP域名才考虑最小化例外,且不要使用`NSAllowsArbitraryLoads`全局放行:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSExceptionDomains</key>
<dict>
<key>legacy.example.com</key>
<dict>
<key>NSIncludesSubdomains</key><true/>
<key>NSExceptionAllowsInsecureHTTPLoads</key><true/>
</dict>
</dict>
</dict>
iOS微信小程序底层同样受ATS约束,若出现`NSURLErrorServerCertificateUntrusted (-1202)`,通常是证书不受信任、链不完整或域名不匹配;出现`NSURLErrorAppTransportSecurityRequiresSecureConnection (-1022)`则是仍走了HTTP或TLS版本过低。修复方向是补齐fullchain、关闭TLS 1.0/1.1、确保证书SAN包含请求域名,并删除不必要的ATS例外。
对比表格:证书类型、覆盖范围与部署方式
下表用于快速选型。通配符不是“无限子域”,微信小程序若请求`a.b.example.com`,`*.example.com`不覆盖,需要`*.b.example.com`或单独SAN。证书有效期按公开信任CA上限398天理解,Let’s Encrypt单独按90天并自动化。
| 证书/部署项 | 覆盖范围 | 验证方式 | 有效期 | 小程序/iOS注意点 |
|---|---|---|---|---|
| DV单域名 | 一个FQDN | DNS或HTTP文件 | ≤398天 | 链完整即可,适合固定API域名 |
| DV通配符 | *.example.com一级子域 | DNS-01 TXT | ≤398天;LE 90天 | 不覆盖根域和二级子域,SAN需加根域 |
| 多域名SAN | 多个指定域名 | 按CA要求 | ≤398天 | 适合example.com+*.example.com混用 |
| Nginx SNI | 同IP多证书 | server_name匹配 | 随证书 | 必须配fullchain,否则iOS报-1202 |
| Apache SNI | 同IP多VirtualHost | ServerName/ServerAlias | 随证书 | 旧版需SSLCertificateChainFile |
选型建议:小程序API域名固定且子域多时用通配符+DNS-01;根域和www都要用时把两个名字写入SAN;有合规展示需求再考虑OV,但不要期待EV绿条。免费证书可用于生产,但必须自动续期和到期监控;商业证书也要按398天上限规划续期,不能按“一年一续”的旧习惯。
常见错误排查:真实报错与定位命令
1)`curl: (60) SSL certificate problem: unable to get local issuer certificate`:服务端未发送中间证书。把Nginx的`ssl_certificate`改为fullchain,Apache新版本用fullchain写入`SSLCertificateFile`,旧版补`SSLCertificateChainFile`。2)`nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)`:证书与私钥不匹配,用`openssl x509 -noout -modulus -in cert.pem | openssl md5`和`openssl rsa -noout -modulus -in key.pem | openssl md5`比对。3)`NET::ERR_CERT_COMMON_NAME_INVALID`:SAN不含当前域名,或通配符层级不匹配;用`openssl x509 -in fullchain.pem -noout -text | grep -A1 ‘Subject Alternative Name’`核对。4)微信小程序`request:fail ssl hand shake error`:检查TLS 1.2、证书过期、SNI选错证书、CDN回源证书链;用`openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null`看返回链。5)iOS`NSURLErrorServerCertificateUntrusted (-1202)`:证书不受信任或链不完整,优先补中间证书并确认域名匹配。6)`x509: certificate signed by unknown authority`:客户端信任库不认自签名或私有CA,小程序/iOS必须用公开受信任CA。排查顺序:先链、再SAN、再TLS版本、最后小程序后台域名和ATS配置。
效果验证与自动化续期:命令、监控与上线检查
部署后先验证证书链和SAN:
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
openssl s_client -connect api.example.com:443 -servername api.example.com -verify_return_error </dev/null
curl -vI https://api.example.com
nmap --script ssl-enum-ciphers -p 443 api.example.com
期望结果:`Verify return code: 0 (ok)`;SAN包含实际域名;`curl`无证书告警;nmap只看到TLS 1.2/1.3且无RC4/3DES。再用`openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -enddate`查看到期日。自动化方面,acme.sh会写入cron,可用`acme.sh –list`和`acme.sh –cron`检查;Let’s Encrypt 90天证书建议提前30天续期,商业证书按398天上限提前30-45天续期。监控脚本可每日执行`openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate`,剩余天数小于30天告警。上线检查清单:fullchain完整、私钥600、TLS 1.0/1.1关闭、HSTS按需开启、微信request合法域名已配置、iOS无多余ATS例外、CDN入口与回源证书均有效。完成后再用微信开发者工具和iOS真机各请求一次,确认无`ssl hand shake error`和`-1202`。
常见问题
不能。`*.example.com`只匹配一级子域,如api.example.com;a.b.example.com属于二级子域,需要`*.b.example.com`或把该域名加入SAN多域名证书。部署前用openssl查看SAN,避免微信小程序请求二级子域时报域名不匹配。
优先查四点:证书链是否完整、SAN是否包含请求域名、TLS是否≥1.2、域名是否已加入request合法域名并完成备案。iOS真机还受ATS约束。用`openssl s_client -showcerts`看服务端是否发送中间证书,缺链就改用fullchain。
适合,但必须自动续期。acme.sh或certbot可提前30天续期并reload Nginx/Apache;用`acme.sh –list`和到期监控确认。90天不是问题,手工续期才是风险。商业证书同样受398天上限约束,不能按旧“一年期”规划。
公开信任TLS证书不能再按一年期签发,当前上限为398天。遇到宣称一年有效期的证书,要确认是否为私有CA、旧库存或非公开信任证书。小程序和iOS只信任公开受信任CA,过期或超期证书会导致请求失败。
不需要。全站HTTPS时保持ATS默认即可;只有历史HTTP域名才做最小化NSExceptionDomains例外,不要用NSAllowsArbitraryLoads全局放行。出现-1022说明仍在走HTTP或TLS过低,应先升级到HTTPS和TLS 1.2+。