SSL 证书申请与 HTTPS 部署全流程:宝塔 / phpStudy / IIS 配置与微信小程序握手失败排查
一、问题背景与根因:小程序为什么强制 HTTPS,旧教程哪些说法已经失效
微信小程序自 2017 年起对 wx.request、wx.uploadFile、wx.connectSocket 等网络接口强制要求 HTTPS,服务端必须同时满足五个条件:证书由受信任 CA 签发(自签名一律拒绝)、TLS 协议版本不低于 1.2、支持前向保密套件(ECDHE 系列)、使用域名而非 IP 访问、中国大陆服务器域名已完成 ICP 备案并在公众平台“服务器域名”白名单中登记。浏览器侧同理,Chrome 从 68 起对 HTTP 页面标记“不安全”,Safari 的 ATS 要求 TLS 1.2 + 前向保密。
但这篇旧文有三处事实已经过时,直接照做会踩坑:
- “有效期一年的证书”已不存在。2020-09-01 起 CA/B Forum 规定公开信任证书单张最长 398 天,Chrome / Safari 会直接拒绝超期证书;Let’s Encrypt 固定 90 天。且已确定 2026-03-15 起缩短至 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天,必须规划自动续期,不能靠人工一年一换。
- “EV 证书地址栏显示公司名”已失效。Chrome 77(2019-09)起移除 EV 标识,Safari、Firefox 同样不再展示,EV 现在只剩合规审计与赔付条款的价值。
- “通配符包含所有二级域名”不准确。
*.example.com只匹配a.example.com这一级,既不匹配裸域example.com,也不匹配a.b.example.com。
线上真实故障的根因排序是:证书链不完整(缺中间证书)> 域名不匹配(SAN 缺失)> TLS 版本或加密套件不满足客户端要求 > 混合内容。部署前先对照下表确认客户端门槛:
| 客户端 | 协议要求 | 证书要求 | 附加限制 |
|---|---|---|---|
| 微信小程序 | TLS 1.2 及以上 | 受信任 CA、SAN 匹配 | 不支持自签名/IP、需备案 |
| iOS ATS | TLS 1.2 及以上 | RSA ≥2048 或 ECC ≥256 | 需前向保密套件 |
| Chrome / Edge | TLS 1.2 及以上 | 有效期 ≤398 天 | 需完整证书链 |
| Android 7+ | TLS 1.2 及以上 | 系统信任库 | 旧机型对交叉签名敏感 |
二、证书选型:DV / OV / EV 与单域名 / 多域名 / 通配符怎么选
选证书要拆成两个独立维度看:验证强度决定审核流程和价格,覆盖范围决定能保护哪些域名,二者互不影响。先看验证强度:
| 类型 | 验证内容 | 签发时长 | 典型用途 |
|---|---|---|---|
| DV 域名型 | 仅验证域名控制权(DNS TXT / 文件) | 几分钟 | 个人站、API 网关、小程序后端 |
| OV 企业型 | 域名 + 企业工商信息人工审核 | 1-5 工作日 | 企业门户、SaaS 平台 |
| EV 增强型 | OV + 更严格的组织核验 | 3-7 工作日 | 金融、支付、合规审计场景 |
再看覆盖范围,这是最容易买错的地方:
- 单域名证书:只保护一个 FQDN,
www.example.com和example.com视为两个域名。 - 多域名证书(SAN / UCC):一张证书可写多个域名,通常赠送 3-5 个 SAN 位,超出按个加价,适合
api./m./static.多个子域。 - 通配符证书:
*.example.com覆盖任意一级子域,但不含裸域,也不覆盖二级子域;签发时一般强制 DNS-01 验证。
免费方案要区分清楚:Let’s Encrypt、ZeroSSL 提供 90 天 DV 证书,支持通配符,可用 acme.sh 或 certbot 全自动续期,是个人站和小程序后端的首选;国内云厂商的“免费 DV”多为 3 个月期且限制张数,同样需要自动化。付费 DV 的价值主要在 398 天有效期、商业保险和人工支持。
选型结论:
- 个人博客、小程序接口、内部测试:Let’s Encrypt 或付费 DV,单域名即可。
- 主域 + www + 多个子域:多域名证书,或直接通配符 + 裸域 SAN 组合。
- 企业官网需要显示组织信息、过等保或投标:OV。
- EV 仅在有明确合规要求时购买,别指望地址栏展示公司名。
三、申请实操:生成 CSR、DNS TXT 验证与 ACME 自动签发
申请前准备三样东西:待签发域名清单、DNS 解析管理权限、Web 服务器类型与版本。所有命令在 Linux / macOS 的 OpenSSL 下执行,Windows 可用 Git Bash 或 WSL。
第一步,生成私钥与 CSR。推荐 2048 位 RSA(兼容性最好),或 P-256 椭圆曲线(握手更快,现代客户端均支持):
# RSA 2048
openssl genrsa -out example.com.key 2048
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=example.com"
# 或 ECC P-256
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=example.com"
私钥权限必须收紧:chmod 600 example.com.key,否则 Nginx 启动会报权限错误,或被扫描器判定为泄露风险。
第二步,检查 CSR 内容。提交前务必确认 Common Name 和 SAN 都正确,SAN 才是现代客户端的校验依据:
openssl req -in example.com.csr -noout -subject -text | grep -A1 "Subject Alternative Name"
第三步,DNS TXT 验证。CA 会给出类似 _dnsauth.example.com 的主机记录和一段随机值,在 DNS 服务商添加 TXT 记录后先本地确认生效再点验证,避免触发风控重试限制:
dig +short TXT _dnsauth.example.com @8.8.8.8
nslookup -type=TXT _dnsauth.example.com 8.8.8.8
三个细节:TXT 值不要手工加英文双引号(多数 DNS 商会自动加,导致校验失败);TTL 设 600 以内便于回滚;主域和 www 都要签发时,务必两个域名都写进 SAN 或分别添加 TXT。
第四步,自动化签发(推荐长期方案)。用 acme.sh 一次配置、永久续期:
curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com
--webroot /www/wwwroot/example.com
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
签发完成后你会拿到三个文件:example.com.key(私钥,绝不能外泄)、example.com.crt(站点证书)、chain.crt(中间证书)。部署时要合并成 fullchain.pem,站点证书在前、中间证书在后,根证书不要放:
cat example.com.crt chain.crt > fullchain.pem
openssl verify -CAfile chain.crt -untrusted chain.crt example.com.crt
四、宝塔面板部署 Nginx 站点并强制 HTTPS
宝塔(BT Panel)是中小站点最常见的环境,操作路径清晰,但仍有几处容易出错。
步骤一:上传或申请证书。登录面板 → 网站 → 目标站点“设置” → SSL。两种方式:
- 免费申请:切到“Let’s Encrypt”标签,勾选
example.com与www.example.com,验证方式选“文件验证”(需 80 端口可访问)或“DNS 验证”,点击申请。 - 已有证书:切到“其他证书”,把
fullchain.pem全部内容粘进“密钥(KEY)”上方的证书框,把example.com.key内容粘进“密钥(KEY)”框,保存。
粘贴顺序错误是最常见的失败原因:把中间证书放在最前面,浏览器会报 NET::ERR_CERT_AUTHORITY_INVALID;只贴站点证书不贴中间证书,安卓端和小程序会直接握手失败。
步骤二:开启强制 HTTPS。SSL 页面上方打开“强制 HTTPS”开关,宝塔会自动写入 301 跳转规则;也可以手工在配置里加:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
步骤三:放行 443 端口。面板放行只是第一层,云服务器安全组是第二层:
# firewalld
firewall-cmd --add-service=https --permanent && firewall-cmd --reload
# ufw
ufw allow 443/tcp
# 确认监听
ss -lntp | grep -E ':80|:443'
步骤四:校验并重载。改完配置不要直接重启,先 nginx -t 检查语法,通过后再 reload,避免整站中断:
nginx -t
nginx -s reload
步骤五:续期保障。Let’s Encrypt 只有 90 天。面板的“计划任务”里默认存在 SSL 自动续签任务,确认状态为“正常”;用 acme.sh 的则检查 crontab 是否有 ~/.acme.sh/acme.sh --cron。续期失败最常见的两个原因是 80 端口被 CDN 或防火墙拦截、DNS API 密钥过期。
特别提醒:如果站点前面挂了 CDN 或反向代理(如 Nginx 反代到 Tomcat),证书必须装在最外层的反代上;同时后端要正确识别 X-Forwarded-Proto,否则 PHP 里判断 $_SERVER['HTTPS'] 为空,会出现“已上 HTTPS 却仍跳转到 http”的死循环。
五、phpStudy(Apache/Nginx)与 IIS 的证书安装
phpStudy v8 面板方式:网站 → 目标站点“管理” → SSL(HTTPS) → 粘贴证书与私钥 → 保存 → 重启对应服务。phpStudy 同时支持 Apache 与 Nginx,切换环境后需要重新配置一次证书路径。
phpStudy 手动 Apache 方式:先确认 httpd.conf 中已启用 SSL 模块并监听 443:
LoadModule ssl_module modules/mod_ssl.so
Include conf/extra/httpd-ssl.conf
Listen 443
然后在 httpd-ssl.conf 中配置站点。注意 Apache 2.4.8 及以上版本可以把站点证书与中间证书合并写在 SSLCertificateFile 里;更早版本必须单独指定 SSLCertificateChainFile,否则链不完整:
<VirtualHost *:443>
ServerName example.com
DocumentRoot "D:/phpstudy_pro/WWW/example.com"
SSLEngine on
SSLCertificateFile "D:/ssl/fullchain.crt"
SSLCertificateKeyFile "D:/ssl/example.com.key"
<Directory "D:/phpstudy_pro/WWW/example.com">
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
IIS 方式:IIS 只认 .pfx(含私钥的 PKCS#12),需要先转换,或直接用 Windows 的 certutil 合并:
openssl pkcs12 -export -out example.com.pfx
-inkey example.com.key -in example.com.crt
-certfile chain.crt -passout pass:YourPassword
导入步骤:Win + R 输入 certlm.msc → 个人 → 证书 → 所有任务 → 导入 → 选择 pfx → 输入密码 → 存储位置选“个人”。关键点:若中间证书没有随 pfx 一起进入“中间证书颁发机构”存储,IIS 对外提供的链就是不完整的,浏览器可能正常(有 AIA 自动补链)但小程序和部分安卓机握手失败。可在“中间证书颁发机构 → 证书”中手动导入 chain.crt。
随后在 IIS 管理器 → 站点 → 右侧“绑定” → 添加 → 类型 https、端口 443、SSL 证书选择刚导入的证书。IIS 8 及以上支持 SNI,多站点共用 443 时勾选“需要服务器名称指示”。命令行验证与绑定:
netsh http show sslcert
netsh http add sslcert ipport=0.0.0.0:443 certhash=<证书指纹> appid={4dc3e181-e14b-4a21-b022-59fc669b0914}
指纹可从证书详情页复制,注意去掉空格。绑定完成后重启站点即可,无需重启整台服务器。
六、配置示例汇总与三平台对比
Nginx 完整配置(宝塔 / phpStudy-Nginx 通用):注意 Nginx 1.25.1 之后 http2 不再写在 listen 行,改为独立指令,写错会导致启动失败。
server {
listen 443 ssl;
http2 on; # Nginx < 1.25.1 请用 listen 443 ssl http2;
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 on;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
add_header Strict-Transport-Security "max-age=31536000" always;
root /www/wwwroot/example.com;
index index.php index.html;
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
IIS 强制跳转(web.config,需安装 URL Rewrite 模块):
<configuration>
<system.webServer>
<rewrite>
<rules>
<rule name="Force HTTPS" stopProcessing="true">
<match url="(.*)" />
<conditions>
<add input="{HTTPS}" pattern="^OFF$" />
</conditions>
<action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
</rule>
</rules>
</rewrite>
</system.webServer>
</configuration>
三平台关键差异对比:
| 项目 | 宝塔面板 | phpStudy | IIS |
|---|---|---|---|
| 证书文件格式 | fullchain.pem + privkey.pem | Apache: .crt(含链) + .key | .pfx(含私钥) |
| 证书存放位置 | /www/server/panel/vhost/cert/域名/ | 自定义目录,注意读权限 | Windows 证书存储“个人” |
| 生效命令 | nginx -t && nginx -s reload | 重启 Apache/Nginx 服务 | 重启站点或 iisreset |
| 强制跳转方式 | 面板开关 / return 301 | .htaccess RewriteRule | web.config URL Rewrite |
| 高频坑 | 证书粘贴顺序、443 未放行 | mod_ssl 未启用、80 被占用 | 中间证书缺失、未勾 SNI |
| 自动续期 | 计划任务内置 | 需自建 acme.sh 定时 | 需自建脚本 + win-acme |
Apache 下的 .htaccess 跳转示例:
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]
三个平台都遵循同一条铁律:改配置前先备份,改完先做语法检查再重载,不要直接重启服务,否则一个分号错误就会导致全站 502 或 403。
七、常见错误排查:真实报错与修复命令
1. curl: (60) SSL certificate problem: unable to get local issuer certificate
服务端证书链不完整,缺中间证书。修复:拼接 fullchain 并验证。
cat example.com.crt chain.crt > fullchain.pem
openssl verify -CAfile chain.crt -untrusted chain.crt example.com.crt
# 期望输出:example.com.crt: OK
2. 小程序 request:fail 未能找到使用指定主机名的服务器 / 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID
域名不在证书 SAN 里。典型场景:只签了 example.com 却用 www.example.com 访问,或买了通配符 *.example.com 却访问裸域。核对命令:
openssl x509 -in fullchain.pem -noout -text | grep -A1 "Subject Alternative Name"
3. 小程序 request:fail ssl handshake failed
服务端未启用 TLS 1.2、加密套件只保留 CBC/RC4/3DES,或证书链不全。逐项验证:
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null 2>&1 | grep -E "Protocol|Cipher|Verify return code"
# Verify return code 必须是 0 (ok);返回 21 表示链不完整,20 表示无法获取本地签发者
4. ERR_SSL_PROTOCOL_ERROR
通常是访问了未监听 443 的端口,或 Nginx 配置未 reload,或客户端被强制降级到 TLS 1.0。检查监听与协议:
ss -lntp | grep 443
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 | grep "Protocol"
5. nginx: [emerg] cannot load certificate “…fullchain.pem”: PEM_read_bio_X509_AUX() failed
文件不是 PEM 格式(比如误传了 .pfx 或 .der),或路径写错、权限不足。用 head -1 fullchain.pem 确认首行是 -----BEGIN CERTIFICATE-----,并 chmod 600 私钥。
6. IIS 站点访问报 HTTP 错误 403.7 – Forbidden
站点绑定的证书与私钥不匹配,或证书未装入“个人”存储,或 pfx 导入时未勾选“密钥可导出”。在 IIS 绑定窗口重新选择证书,或 certlm.msc 中确认证书图标带钥匙标记。
7. 浏览器控制台 Mixed Content 警告
报错形如 The page at 'https://a.com/' was loaded over HTTPS, but requested an insecure XMLHttpRequest endpoint 'http://a.com/api'。把页面内所有 http:// 资源改为相对协议 // 或 https,并加响应头 Content-Security-Policy: upgrade-insecure-requests。
8. NET::ERR_CERT_DATE_INVALID
证书已过期或服务器系统时间错误。先 date -u 核对时间,再 openssl x509 -in fullchain.pem -noout -dates 核对有效期。
八、效果验证:命令、SSL Labs 与小程序真机
部署完成后不要只看浏览器绿锁,按下面四层依次验证。
第一层,协议与状态码。
curl -I https://example.com
curl -I http://example.com # 应返回 301 且 Location 指向 https
curl -vI https://example.com 2>&1 | grep -E "SSL connection|subject|expire"
第二层,证书链完整性。这是决定小程序能否握手的关键:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
输出中 Verify return code 必须为 0 (ok);-showcerts 应至少返回两张证书(站点证书 + 中间证书)。只有一张说明链不完整。
第三层,到期监控脚本。证书有效期已缩短到 398 天甚至更短,人工记忆必然出事,建议所有站点上监控:
#!/bin/bash
DOMAIN=example.com
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ($(date -d "$END" +%s) - $(date +%s)) / 86400 ))
echo "$DOMAIN 剩余 $DAYS 天"
[ $DAYS -lt 15 ] && echo "$DOMAIN 证书将在 $DAYS 天后到期" | mail -s "SSL 到期告警" admin@example.com
把脚本加入 crontab 每天执行一次即可。
第四层,评级与真机。用 SSL Labs(ssllabs.com/ssltest)跑一次完整评估,目标 A 及以上;出现 “Chain issues: Incomplete” 说明中间证书仍缺失。小程序侧分两步:开发者工具中“详情 → 本地设置 → 不校验合法域名”只能用于调试,真机预览必须走真实校验;同时在公众平台“开发管理 → 开发设置 → 服务器域名”里把 https://api.example.com 加入 request 合法域名,注意该项有修改次数限制,别频繁改动。
最后提醒 HSTS:首次上线不要直接设 max-age=31536000 并提交 preload,建议先设 max-age=300 观察一周,确认全站子域都已支持 HTTPS 后再逐步加长,否则回退极其麻烦。
常见问题
免费证书能用于微信小程序生产环境吗?
可以。小程序只校验证书是否由受信任 CA 签发、域名是否匹配、TLS 是否 ≥1.2,并不区分免费或付费。Let’s Encrypt、ZeroSSL 的 DV 证书完全满足要求,前提是必须做好自动续期——它们只有 90 天有效期,一旦续期失败,小程序会立刻大面积报 request:fail ssl handshake failed。付费证书的优势在于 398 天有效期、商业保险和人工支持。
证书有效期到底是多少天?为什么买不到“一年期”了?
2020-09-01 起 CA/B Forum 规定公开信任证书单张最长 398 天,主流浏览器会拒绝超期证书,因此所有 CA 都改成了 398 天(约 13 个月)。Let’s Encrypt 固定 90 天。行业已确定进一步缩短:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。无论买哪种证书,都必须部署自动续期与到期监控。
一张证书能同时保护主域名、www 和多个子域名吗?
可以,但要选对类型。多域名证书(SAN)可在一张证书里写入多个 FQDN,例如 example.com、www.example.com、api.example.com。通配符证书 *.example.com 覆盖任意一级子域,但不包含裸域 example.com,也不覆盖 a.b.example.com 这类二级子域,需要额外添加 SAN。
为什么浏览器显示安全,小程序却握手失败?
最常见原因是证书链不完整。桌面浏览器支持 AIA 自动抓取中间证书,所以看起来正常;而小程序、部分安卓机和 iOS 不做自动补链,缺中间证书就直接失败。用 openssl s_client -showcerts 检查是否返回两张以上证书,并把 cat 站点证书 中间证书 > fullchain.pem 后重新加载即可。其次是服务器只开了 TLS 1.0/1.1 或只保留 CBC 套件。
更换证书后需要重启服务器吗?
Nginx 不需要重启,先 nginx -t 校验语法,再 nginx -s reload 平滑加载即可,业务不中断;Apache 用 apachectl -k graceful;IIS 重新绑定证书或重启对应站点即可,不必执行 iisreset 重启整机。切记不要跳过语法检查直接重启,一个配置错误就会导致全站不可用。
私钥泄露了怎么办?
立即吊销并重签:在 CA 控制台提交吊销(走 OCSP/CRL),重新生成一对新密钥和新 CSR 签发证书,然后全量替换服务器配置并 reload。不要复用旧私钥。同时排查泄露路径,常见原因是私钥文件权限过宽(应 chmod 600)、误传到代码仓库或备份目录被公开访问。