跳到主要内容
ssl证书按装

微信小程序 HTTPS 配置与 SSL 证书申请、代购、部署、续费全流程(2026 实操版)

微信小程序 HTTPS 配置与 SSL 证书申请、代购、部署、续费全流程(2026 实操版) — 微信小程序 HTTPS 配置与 SSL 证书申请、代购、部署、续费全流程(2026 实操版)

问题背景与根因:小程序为什么绕不开 HTTPS 与证书链

微信小程序的网络请求从设计上就强制使用 HTTPS。wx.request、wx.uploadFile、wx.downloadFile 等接口访问的服务器域名,必须在小程序后台配置为合法域名,域名需完成 ICP 备案,证书必须由受信任 CA 签发,且证书链完整、域名匹配、未过期。很多团队以为“买了 HTTPS 证书就完事”,实际线上故障往往出在证书链、SNI、TLS 协议版本、443 安全组和混合内容上。常见根因包括:Nginx 只配置了 leaf 证书,没有配置中间证书;CSR 或证书 SAN 缺少 api.example.com;公共信任 TLS 证书最长有效期为 398 天,Let’s Encrypt 为 90 天,过期未续费;服务器仍启用 TLS 1.0/1.1;ECS 安全组未放行 443;页面 HTTPS 中夹带 http:// 资源;HTTP 301 跳转被 API POST 依赖。排查时先看握手和证书链,不要先改业务代码。

openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null

输出中重点看 Verify return code: 0 (ok)、subjectAltName、issuer 和 notAfter。若出现 verify error:num=20 unable to get local issuer certificate,通常是中间证书缺失;若出现 no alternative certificate subject name matches target host name,说明证书 SAN 不含当前域名;若出现 certificate has expired,说明证书已过期。微信小程序真机不会信任自签名证书,测试环境也应使用受信任 CA 证书或独立测试域名。HTTPS 只是第一层,完整链、TLS 1.2/1.3、HSTS 和 301 跳转策略共同决定可用性。对于“SSL证书代购、过期续费、HTTPS证书安装配置部署服务”,验收标准不是拿到文件,而是浏览器、curl、openssl 和微信开发者工具同时通过。

证书选型与有效期:DV、OV、EV、单域名、多域名、通配符怎么选

微信小程序一般选择域名型 DV SSL 证书即可,因为小程序校验的是 CA 是否受信任、域名是否匹配、证书链是否完整,并不要求 OV 或 EV。公共信任 TLS 证书最长有效期为 398 天,Let’s Encrypt 免费证书有效期为 90 天,商业 CA 代购时也要确认实际 notAfter,不要沿用“默认一年证书”的旧说法。OV 需要企业资料审核,通常 3-5 个工作日;EV 审核更严,但主流浏览器已不再普遍在地址栏直接显示公司名称,不要只为“地址栏公司名”支付溢价。单域名证书只保护一个精确域名;多域名 SAN 证书可把 api.example.com、www.example.com、m.example.com 放在一张证书中;通配符证书如 *.example.com 只匹配一级子域,不匹配 a.b.example.com,多级子域需单独加入 SAN 或另配通配符。证书到期前 30 天应完成续费和新链替换。

类型 适用场景 签发/审核 小程序建议
DV SSL 个人站点、API、下载、测试转生产 域名验证,几分钟到数小时 常用,足够
OV SSL 企业官网、需要组织身份信息 企业资料审核,3-5 工作日 非必须
EV SSL 金融、电商等高信任场景 严格审核,时间更长 按合规需求选,不依赖地址栏展示
单域名 api.example.com 仅一个精确域名 最常见
多域名 SAN api、www、m 等多个域名 一张证书多个 SAN 便于统一续费
通配符 *.example.com 匹配一级子域 不覆盖 a.b.example.com

选型时还要确认私钥归属、域名控制权、证书链文件、续费主体和代理商交付物。商业 CA 代购不应只给一个 cert.pem,而应交付 fullchain.pem 和私钥,或提供 PFX 及密码。若使用免费 Let’s Encrypt,90 天周期必须自动化;若使用商业证书,398 天也要设置到期监控。小程序 API 域名建议直接使用 HTTPS,不要依赖 HTTP 301 跳转,因为 301 对 POST 的语义可能改变请求方法,部分客户端和网关处理不一致。HSTS 可降低降级劫持风险,但上线前要确认全站子域 HTTPS 已就绪。

申请前准备与 CSR、域名验证实操

申请 SSL 安全数字证书前,先准备域名、域名管理权限、服务器操作系统和 Web 服务版本。CSR 可在服务器生成,私钥不要外传。以下命令适用于 OpenSSL 1.1.1 及以上版本,生成 RSA 2048 私钥和带 SAN 的 CSR;生产环境也可使用 ECDSA,但需确认 CA 和 Web 服务器支持。

openssl genrsa -out example.com.key 2048
openssl req -new -key example.com.key -out example.com.csr -subj '/C=CN/ST=Shanghai/L=Shanghai/O=Example/CN=api.example.com' -addext 'subjectAltName=DNS:api.example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'

DV 证书通常通过 DNS TXT 或 HTTP 文件验证。DNS 验证时,按 CA 控制台给出的主机记录添加 TXT,例如 _dnsauth.api.example.com,等待解析生效后用 dig 检查。不同 CA 的验证主机名不同,必须以控制台为准。HTTP 验证需确保 http://api.example.com/.well-known/acme-challenge/ 可访问,且没有被 301 到不可达地址。Let’s Encrypt 可用 acme.sh 或 certbot 自动签发,90 天有效期,适合自动化运维。

curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --issue -d api.example.com -d www.example.com --webroot /var/www/html
~/.acme.sh/acme.sh --issue -d api.example.com --nginx

商业 CA 代购时,提交 CSR 后完成域名验证,等待签发。收到证书后检查 SAN 是否包含全部业务域名、有效期是否与订单一致、证书链是否完整。若使用通配符,CSR 中写 DNS:*.example.com,并注意它不覆盖多级子域。ECS 云主机还要提前确认安全组入方向放行 443,系统防火墙放行 443/tcp。域名未备案、解析未生效、TXT 记录冲突都会导致验证失败,应先修 DNS 再重试,不要反复提交订单。

Nginx、Apache、Tomcat 与 IIS 配置示例

部署 HTTPS 证书时,Nginx 应使用 fullchain.pem,而不是只含站点证书的 cert.pem。以下配置同时完成 HTTP 301 跳转、TLS 1.2/1.3、HSTS 和反向代理。若后端是 Java 服务,proxy_pass 指向本地端口,Host 头必须保留。

server {
    listen 80;
    server_name api.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    server_name api.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';
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security 'max-age=31536000' always;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto https;
    }
}

Apache 2.4 配置示例如下,fullchain 可放在 SSLCertificateFile,若版本较旧则单独配置 SSLCertificateChainFile。Tomcat 使用 JKS 或 PKCS12 时,需把 fullchain 和私钥导入 keystore,并在 Connector 中启用 SSLHostConfig。IIS 通过 certlm.msc 导入 PFX,在站点绑定中选 443 和对应证书,注意中间证书随 PFX 导入。

<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
</VirtualHost>
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true'>
  <SSLHostConfig>
    <Certificate certificateKeystoreFile='/opt/tomcat/conf/example.p12' certificateKeystorePassword='changeit' type='RSA'/>
  </SSLHostConfig>
</Connector>

修改后执行 nginx -t 再 reload;Apache 执行 httpd -t 后 reload;Tomcat 重启或热加载;IIS 绑定后重启站点。配置完成后必须检查 443 监听和证书链,不能只看配置文件没有语法错误。

微信小程序后台与服务器联调:合法域名、443 端口与 TLS 握手

服务端证书部署完成后,进入微信公众平台小程序后台,在开发管理-开发设置-服务器域名中配置 request 合法域名,例如 https://api.example.com。域名需备案,不能使用 IP 或 localhost,建议使用 443 默认端口;若使用非 443 端口,要同时确认后台配置、安全组和防火墙。ECS 安全组入方向放行 443/tcp,系统防火墙执行 firewall-cmd –add-port=443/tcp –permanent 或 ufw allow 443/tcp。随后用 curl 和 openssl 做服务器侧验证,再用微信开发者工具发起请求。

curl -I https://api.example.com/health
curl -v --tlsv1.2 https://api.example.com/health
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

小程序代码中直接请求 HTTPS 地址,fail 回调要打印 errMsg,便于区分证书、域名和网络错误。若页面本身是 HTTPS,接口、图片、字体、WebSocket 也必须使用 HTTPS/WSS,否则会出现混合内容。微信开发者工具可勾选不校验合法域名用于本地调试,但真机必须配置合法域名并使用受信任证书。

wx.request({
  url: 'https://api.example.com/health',
  method: 'GET',
  success(res) { console.log(res.statusCode, res.data) },
  fail(err) { console.error(err.errMsg) }
})

联调时若出现 request:fail ssl handshake error,优先检查 TLS 版本、证书链、SNI、系统时间和安全组,不要先怀疑小程序代码。若出现 403 或 404,则证书握手已通过,问题在业务路由或 WAF。上线前建议在开发者工具和真机各验证一次。

证书续费与自动化:398 天与 90 天有效期下的运维策略

公共信任 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天,因此“一年一续”的旧流程必须改为到期前 30 天自动续费。acme.sh 可用 install-cert 把新证书安装到 Nginx 目录并 reload;certbot 用 renew 配合 deploy-hook。续费后必须确认 fullchain 已更新,而不是只更新 leaf 证书。

~/.acme.sh/acme.sh --install-cert -d api.example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/fullchain.pem --reloadcmd 'systemctl reload nginx'
~/.acme.sh/acme.sh --renew -d api.example.com --days 30
certbot renew --dry-run
certbot renew --deploy-hook 'systemctl reload nginx'

商业 CA 证书代购或续费时,确认新证书 SAN 与原证书一致、私钥匹配、链文件完整。到期监控可用 openssl 读取 notAfter,也可用监控平台探测 443。不要等到浏览器报 NET::ERR_CERT_DATE_INVALID 才处理。若使用多域名或通配符,续费时检查新增子域是否已加入 SAN。

openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result} %{time_total}' https://api.example.com/health

自动化脚本应加失败告警,reload 前先 nginx -t,避免证书文件损坏导致服务中断。若使用负载均衡或多台 ECS,证书需同步到所有节点,或统一在 SLB/CLB 上卸载 TLS。续费窗口建议设置为到期前 30 天,Let’s Encrypt 可更早;监控至少每天一次。

常见错误排查:真实报错、根因与修复命令

第一类报错是 curl: (60) SSL certificate problem: unable to get local issuer certificate,根因是服务端未发送中间证书或客户端 CA 库过旧。Nginx 改用 fullchain.pem,Apache 配置 SSLCertificateChainFile,系统执行 update-ca-certificates 或 yum install ca-certificates。第二类是 curl: (60) SSL: no alternative certificate subject name matches target host name,说明证书 SAN 不含请求域名,需要重签 CSR 并加入 DNS:api.example.com。第三类是 openssl s_client 输出 verify error:num=10:certificate has expired,直接续费并 reload。

curl -Iv https://api.example.com/health
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null
ss -lntp | grep 443
firewall-cmd --list-ports

微信侧常见报错 request:fail ssl handshake error,根因可能是 TLS 1.0/1.1 未关闭或仅支持低版本、证书链不完整、SNI 未返回正确证书、ECS 安全组未放行 443、服务器时间偏差。配置 ssl_protocols TLSv1.2 TLSv1.3 并校时。ERR_CONNECTION_TIMED_OUT 或 443 超时,先查安全组和防火墙。Mixed Content: The page at https://… was loaded over HTTPS, but requested an insecure resource http://…,需把资源改为 HTTPS 或相对协议。NET::ERR_CERT_DATE_INVALID 检查证书 notAfter 和系统时间。HTTP 301 对 POST 可能改变方法,API 应直接 HTTPS。

排查顺序建议:curl -Iv 看握手,openssl s_client 看链和 SAN,ss 看监听,firewall-cmd 看端口,微信开发者工具看 errMsg,最后查业务日志。每次只改一个变量,避免同时换证书、改协议和改 DNS 导致无法定位。

效果验证与上线验收清单

上线验收要覆盖证书链、协议版本、域名匹配、301 跳转、HSTS、443 监听和小程序真机。先看证书主体、签发者、有效期和 SAN,再确认 verify return code 为 0。用 curl 检查 HTTP 状态码和证书校验结果,用 openssl 检查 TLS 1.2 握手,用 nmap 枚举协议套件,用 SSL Labs 做外部评分。微信开发者工具和真机各发起一次 wx.request,确认无 ssl handshake error。

openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result} %{time_total}' https://api.example.com/health
curl -I http://api.example.com
curl -sI https://api.example.com | grep -i strict-transport-security
nmap --script ssl-enum-ciphers -p443 api.example.com

验收表建议包含:证书未过期、SAN 包含 api.example.com、链完整、TLS 1.2/1.3 可用、TLS 1.0/1.1 关闭、80 端口 301 到 443、443 安全组放行、HSTS 头存在、无混合内容、小程序合法域名已配置、真机请求成功、续费监控已启用。若使用商业 CA 代购,保存证书订单、CSR、私钥备份和到期时间。若使用 Let’s Encrypt,确认 cron 或 systemd timer 已启用。

最终效果应是浏览器地址栏锁标志正常、curl 返回 ssl_verify_result 为 0、微信小程序 request 成功、HTTP 自动跳转 HTTPS、证书到期前自动续费。只有命令验证和真机验证都通过,才算完成 SSL 安全数字证书安装配置部署服务。

常见问题

微信小程序必须使用 OV 或 EV 证书吗?

通常不需要。小程序校验受信任 CA、域名匹配和证书链完整,DV 证书即可满足大多数 API 场景。OV/EV 适用于企业身份展示或合规要求,但 EV 已不再普遍在地址栏显示公司名。

SSL 证书有效期到底是 398 天还是 90 天?

公共信任 TLS 证书最长有效期为 398 天;Let’s Encrypt 免费证书为 90 天。商业 CA 代购时以证书 notAfter 为准,并至少在到期前 30 天续费。

通配符证书能覆盖多级子域吗?

不能。*.example.com 只匹配一级子域如 api.example.com,不匹配 a.b.example.com。多级子域需要单独加入 SAN,或使用对应的多级通配符方案。

已经配置 HTTPS,小程序仍报 ssl handshake error 怎么办?

依次检查 TLS 1.2/1.3、fullchain 证书链、SNI、443 安全组、服务器时间和小程序合法域名。用 openssl s_client 和 curl -Iv 复现,确认 verify return code 为 0。

能否使用自签名证书测试小程序?

微信开发者工具可临时忽略域名校验做本地调试,但真机不信任自签名证书。测试环境也应使用受信任 CA 证书,或使用独立测试域名和 DV 证书。

内容审核

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