SSL/TLS 证书部署与 HTTPS 域名实战:微信小程序 ATS、TLS 1.2、多站点与排错指南
问题背景与根因:HTTPS、SSL 证书与小程序 ATS 的硬门槛
很多站点已经购买 https 证书或 SSL 证书,但微信小程序仍然提示请求失败,浏览器地址栏也没有正常安全标识。根因通常不是“证书没买”,而是证书链、域名匹配、TLS 版本、SNI 多站点或页面混合内容没有处理完整。微信小程序的 wx.request 以及 iOS 的 ATS 检测,核心要求是:使用受信任 CA 签发的 https 域名证书、域名与证书 SAN 一致、TLS 1.2 及以上可握手、证书链完整、服务器时间准确。网站服务器方面,Nginx、Apache、IIS、Tomcat 都可以部署,但老版本限制明显:Windows 2003 IIS6 不支持小程序 ATS;OpenSSL 低于 1.0.1 的环境通常不支持 TLS 1.2,常见于老集成环境如 phpstudy2014。另一个高频根因是多站点:IIS6、IIS7.5 以及 Tomcat 8.5 以前版本在多站点 HTTPS 上常受“单 IP 单证书”限制,需要 SNI 或独立 IP。证书本身绑定域名,不绑定服务器 IP,更换服务器时迁移私钥、证书和中间链并重新配置即可。排查时先看证书链是否完整,再看 TLS 1.2 握手,最后看页面是否引用 http 资源。
证书选型、有效期与 CSR 生成
选型先看域名结构:单域名证书只保护一个 FQDN;多域名 SAN 证书可放多个域名;通配符证书保护 *.example.com,但不保护 example.com 本身,也不保护多级子域。域名后缀 .com/.cn/.net/.top/.org 等不是决定因素,关键是域名控制权验证。有效期必须写准确:公开可信 TLS 证书曾以 398 天为上限,按 CA/B Forum SC-081 规则,2026-03-15 起新签发证书最长 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天;Let’s Encrypt 仍为 90 天,应使用 ACME 自动续期。生成 CSR 时把常用域名写入 SAN,避免只写 CN 导致 www 访问失败:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
签发后必须使用 fullchain 部署,即站点证书加中间 CA,不要只放叶子证书。私钥权限建议 600,证书 644。更换服务器时复制私钥和 fullchain 即可,不需要重新绑定 IP。
完整实操:Nginx/Apache 安装证书并强制 TLS 1.2+
Nginx 部署时把 80 端口 301 到 443,443 站点加载 fullchain 和私钥,并显式启用 TLS 1.2/1.3。配置后先 nginx -t 再 reload,避免直接重启造成全站中断:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
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;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}
nginx -t && systemctl reload nginx
Apache 2.4.8 及以上可把 fullchain 直接写入 SSLCertificateFile;老版本才额外使用 SSLCertificateChainFile。启用 SSLProtocol 时关闭 SSLv3、TLS1.0、TLS1.1,保留 TLSv1.2 与 TLSv1.3:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
Header always set Strict-Transport-Security 'max-age=31536000; includeSubDomains'
</VirtualHost>
apachectl configtest && systemctl reload httpd
配置标准不是“能打开 https 就算完成”,而是 TLS 1.2 握手成功、证书链完整、域名匹配、无混合内容。
IIS/Tomcat 配置示例与多站点 SNI 限制
IIS8/Windows Server 2012 及以上支持 SNI,可在同一 IP 的 443 端口绑定多个站点证书;IIS6 和 IIS7.5 通常不支持 SNI,多站点 HTTPS 往往需要独立 IP 或多域名/通配符证书。导入 PFX 并创建 SNI 绑定的 PowerShell 示例如下:
Import-PfxCertificate -FilePath 'C:/cert/example.pfx' -CertStoreLocation Cert:LocalMachineMy
New-WebBinding -Name 'Default Web Site' -Protocol https -Port 443 -HostHeader 'example.com' -SslFlags 1
netsh http add sslcert hostnameport=example.com:443 certhash=THUMBPRINT appid={GUID} certstorename=MY
Tomcat 8.5 以前通常一个 Connector 只能配置一张证书,多站点 HTTPS 受限;Tomcat 8.5 及以上可用 SSLHostConfig 按 hostName 配置多证书。PKCS12 示例:
<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true'>
<SSLHostConfig hostName='example.com' protocols='TLSv1.2,TLSv1.3'>
<Certificate certificateKeystoreFile='conf/example.p12' certificateKeystorePassword='changeit' type='RSA'/>
</SSLHostConfig>
</Connector>
若仍使用 IIS6 或 IIS7.5 且站点是 ASP,优先升级到 IIS8;不能升级时再考虑独立 IP 或多域名证书。Tomcat 老版本建议升级,否则 TLS 1.2 与 SNI 都可能不满足小程序要求。
微信小程序 ATS 与 HTTPS 域名检测:TLS 1.2、证书链和域名匹配
微信小程序后台配置的 request 合法域名必须是 https 域名,不能使用 IP、localhost 或未配置域名;国内小程序域名通常还要求完成 ICP 备案。iOS 侧受 ATS 约束,要求 TLS 1.2 及以上、受信任证书链、SHA256 签名、RSA 2048 位或 ECC 256 位以上。常见报错是 request:fail ssl hand shake error,表示握手阶段失败,不一定是业务代码问题。先用命令验证 TLS 1.2 和证书链:
echo | openssl s_client -connect example.com:443 -servername example.com -tls1_2
openssl s_client -connect example.com:443 -servername example.com -showcerts
curl -I https://example.com
curl -v https://example.com 2>&1 | grep -E 'SSL|TLS|subject|issuer'
输出中要看到 Verify return code: 0 (ok),证书 subject 和 SAN 包含请求域名。若 OpenSSL 版本低于 1.0.1,或服务器只开 TLS1.0,微信 iOS 端会直接失败。Windows 2003 IIS6 不支持 ATS,应升级系统或前置 Nginx/Apache 做 TLS 终止。证书链不完整时,Android 可能正常而 iOS 失败,必须部署 fullchain。
CDN、虚拟主机与混合内容:小绿锁不显示的真实原因
使用 CDN 时,证书通常部署在 CDN 边缘节点,源站可保留 http 或另配证书;需要在 CDN 控制台开启 HTTPS 并上传证书链。虚拟主机能否安装 SSL 证书取决于提供商,有的控制面板没有入口但客服可手工部署。证书装好后浏览器没有小绿锁、360 显示灰色、Chrome 不显示安全字样,最常见原因是 https 页面引用了 http 的 js、css、img、字体或接口,即混合内容。用命令快速扫描:
curl -s https://example.com | grep -n 'http://'
curl -s https://example.com | grep -nE 'src=|href=' | grep 'http://'
浏览器控制台会出现 Mixed Content: The page at https://… was loaded over HTTPS, but requested an insecure resource http://…。修复方式是把页面内资源改为 https 相对协议或绝对 https,接口也统一 https。若使用 CDN,还要确认回源协议、证书链和缓存没有返回旧页面。安装 SSL 证书并使用 https 可防止运营商在页面中强插广告等劫持,但不能替代 HSTS、CSP 和代码层安全。
对比表格:服务器版本、多证书、ATS 与配置要点
| 环境 | 单 IP 多证书/SNI | TLS 1.2 与小程序 ATS | 配置要点 |
|---|---|---|---|
| Nginx 常用版本 | 支持 SNI,多 server 多证书 | 支持,显式开 TLSv1.2/TLSv1.3 | fullchain + 私钥,nginx -t 后 reload |
| Apache 2.4+ | 支持 SNI | 支持,关闭 TLS1.0/1.1 | SSLProtocol、fullchain、configtest |
| IIS6/Windows 2003 | 不支持 SNI,每 IP 一张 | 不满足 ATS,建议升级 | 前置 TLS 终止或升级 IIS8+ |
| IIS7.5/Windows 2008 R2 | 通常无 SNI,每 IP 一张 | 需补丁并启用 TLS1.2 | 多站点用独立 IP 或多域名证书 |
| IIS8+/Windows 2012+ | 支持 SNI | 支持 | 绑定勾选 SNI,导入 PFX |
| Tomcat 8.5 以前 | 单 Connector 一张证书 | 取决于 JSSE 版本 | 升级 Tomcat 或独立 IP |
| Tomcat 8.5+ | 支持 SSLHostConfig 多证书 | 支持 TLSv1.2/TLSv1.3 | PKCS12/JKS,按 hostName 配置 |
| Let’s Encrypt | 取决于 Web 服务器 SNI | 支持 | 90 天有效期,ACME 自动续期 |
表格中的“支持”仍要以实际版本和编译参数为准;老 OpenSSL、老 JSSE、老 Windows 补丁状态都会改变结果。公开可信证书有效期规则已从 398 天逐步缩短到 200 天、100 天、47 天,运维必须把续期监控纳入告警。
常见错误排查与效果验证
第一类错误是私钥与证书不匹配: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 与 openssl rsa -noout -modulus 比对哈希,不一致就换回正确私钥。第二类是证书链不完整:curl: (60) SSL certificate problem: unable to get local issuer certificate,或 openssl 输出 verify error:num=20:unable to get local issuer certificate,需部署 fullchain。第三类是证书不受信任:浏览器出现 NET::ERR_CERT_AUTHORITY_INVALID,多为自签证书、根证书未预置或系统时间错误。第四类是混合内容:Mixed Content: The page at https://… was loaded over HTTPS, but requested an insecure resource http://…,需改资源链接。第五类是小程序报 request:fail ssl hand shake error,重点查 TLS1.2、证书链、SNI 和域名是否在合法域名列表。IIS 若出现 HTTP 403.4 – Forbidden: SSL is required to view this resource,检查站点是否强制 SSL 但 443 绑定错误。验证命令如下:
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
openssl s_client -connect example.com:443 -servername example.com -tls1_2 -brief
curl -I https://example.com
curl -s https://example.com | grep -n 'http://'
nginx -t
apachectl configtest
最终验收应满足:https 可访问并 301 跳转、TLS1.2 握手成功、证书链 Verify return code 为 0、SAN 覆盖实际域名、页面无 http 资源、微信开发者工具和真机均请求成功。不要只看浏览器能打开,iOS 与小程序往往更严格。
常见问题
微信小程序必须使用 TLS 1.2 吗?Let’s Encrypt 90 天证书能用吗?
必须满足 TLS 1.2 及以上,Let’s Encrypt 证书可以用,但有效期 90 天,必须配置 ACME 自动续期和到期告警。证书链要完整,域名要在小程序后台合法域名中。
一个服务器 IP 能安装几张 SSL 证书?
支持 SNI 的 Nginx、Apache、IIS8+、Tomcat 8.5+ 可在同一 IP 的 443 端口部署多张证书;IIS6、IIS7.5 和 Tomcat 8.5 以前通常受单 IP 单证书限制,需要独立 IP、多域名证书或升级。
安装 SSL 证书能防御运营商劫持吗?
使用受信任 https 证书并全站 https,可以防止运营商在网页中强插广告等常见劫持;但不能替代 HSTS、CSP、代码审计和服务器安全加固。
证书安装后浏览器没有小绿锁怎么办?
先看证书链是否完整、域名是否匹配、系统时间是否正确,再检查页面是否引用 http 的 js、css、img 或接口。混合内容会导致 Chrome、360 等不显示安全标识。
虚拟主机和 CDN 可以安装 SSL 证书吗?
虚拟主机需咨询提供商,有的面板无入口但可手工部署;CDN 一般在控制台上传证书并开启 HTTPS,部分免费版也支持,具体以厂商功能为准。
证书最长有效期还是 398 天吗?
398 天是旧上限。按 CA/B Forum SC-081,2026-03-15 起新签发公开可信 TLS 证书最长 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天;Let’s Encrypt 仍为 90 天,应自动化续期。