微信小程序 HTTPS 证书申请与 Nginx SSL 配置实战指南
问题背景与根因:小程序为什么必须配置 HTTPS
微信小程序从上线起就要求网络请求使用 HTTPS,服务端证书必须由受信任 CA 签发,TLS 版本建议 TLS 1.2 及以上。很多站点不是不会写 Nginx 配置,而是证书链不完整、证书过期、域名与证书 SAN 不匹配、ECS 安全组 443 未放行、SNI 未命中、HTTP 301 跳转被小程序直接请求、页面混合内容等原因导致 https 配置失败。小程序后台的 request 合法域名必须填写 https://example.com 这类域名,不能填 IP、localhost、带端口或带路径的地址;使用中国大陆服务器时通常还要求域名完成 ICP 备案。苹果 ATS 与防广告劫持场景同样偏好完整、可信的 TLS 链路。需要注意:公开信任 TLS 证书单张最长有效期为 398 天,Let’s Encrypt 免费证书有效期为 90 天,旧文章中默认一年有效期的说法已经过时。生产环境要把证书到期监控、自动续期和 443 端口开放纳入上线检查清单。
证书类型与选型:DV、OV、EV 与域名覆盖范围
小程序配置证书常用 DV 域名型证书,几分钟即可签发,适合个人站点、API 域名、iOS 下载页和大多数业务系统。OV 企业型需要 3 至 5 个工作日审核,证书主题包含企业信息;EV 增强型审核更严,浏览器展示策略已与早期不同,不必为地址栏公司名盲目加预算。按域名覆盖范围分为单域名、多域名和通配符:单域名只保护一个 FQDN;多域名通过 SAN 保护多个不同域名;通配符 *.example.com 只覆盖一级子域名,不覆盖主域名 example.com,也不覆盖 a.b.example.com。证书支持 Nginx、Apache、IIS、Tomcat 等服务端,但不同服务端对证书链文件格式要求不同,Nginx 使用 fullchain.pem 加 privkey.pem 最稳妥。证书属于特殊商品,购买前应确认域名、服务器数量和部署方式,避免因域名填错造成退换困难。
| 类型 | 审核速度 | 适用场景 | 注意事项 |
|---|---|---|---|
| DV | 几分钟到数小时 | 小程序 API、个人站、测试转生产 | 只验证域名控制权,最常见 |
| OV | 3 至 5 个工作日 | 企业门户、SaaS、合作方验收 | 需企业资料,证书含组织信息 |
| EV | 更长 | 金融、电商、强合规场景 | 价格高,不必用于普通小程序 |
| 覆盖方式 | 示例 | 是否覆盖 |
|---|---|---|
| 单域名 | api.example.com | 仅该域名 |
| 多域名 SAN | api.example.com、www.example.com | 列出的域名 |
| 通配符 | *.example.com | a.example.com,不覆盖 example.com 和 a.b.example.com |
申请前准备与 CSR 生成:域名、TXT 与 OpenSSL 命令
申请前准备三项:一是要申请证书的域名清单;二是域名管理权限,按 CA 要求添加 TXT 解析记录完成域名验证;三是 Web 服务器操作系统版本与 Nginx、Apache、IIS、Tomcat 版本。云上 ECS 还要确认安全组和系统防火墙放行 443。生成 CSR 时私钥必须留在自己服务器,不能发给 CA。下面命令可直接执行,把 example.com 替换为真实域名;多域名用 SAN 一次写全,通配符把 CN 改为 *.example.com,并在 SAN 中同时写 DNS:*.example.com 和 DNS:example.com。
openssl req -new -newkey rsa:2048 -sha256 -nodes -keyout example.com.key -out example.com.csr -subj /C=CN/O=Example/CN=example.com -addext subjectAltName=DNS:example.com,DNS:www.example.com
openssl req -in example.com.csr -noout -text
openssl rsa -in example.com.key -check
检查 CSR 中的 Subject、SAN 和公钥算法,确认没有多空格、错域名或漏写 www。CA 签发后通常得到站点证书 cert.pem 和中间链 chain.pem,Nginx 要合并为 fullchain.pem,顺序是站点证书在前、中间 CA 在后。私钥权限建议 600,属主 root。若使用 Let’s Encrypt,可直接用 certbot 申请,证书有效期 90 天,必须配置自动续期;商业证书同样受 398 天上限约束,提前 30 天续期更安全。
Nginx SSL 配置示例:443、301 跳转与 TLS 参数
Nginx 证书配置的核心是 listen 443 ssl、ssl_certificate 指向 fullchain.pem、ssl_certificate_key 指向私钥,并保留 80 端口免费 HTTP 301 跳转到 HTTPS。TLS 只启用 TLSv1.2 和 TLSv1.3,关闭老旧的 SSLv3、TLSv1.0、TLSv1.1。Nginx 1.25.1 及以上使用 http2 on;旧版本可写 listen 443 ssl http2。若站点在云负载均衡、CDN 或 WAF 后面,证书应上传到云证书服务,并确保回源协议为 HTTPS。
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
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/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
add_header Strict-Transport-Security max-age=31536000;
location / {
root /var/www/html;
index index.html;
}
}
小程序请求域名应直接使用 https,不要依赖 301 跳转完成协议切换;合法域名不能带路径和端口。HSTS 首次上线建议先用较短 max-age,确认全站 HTTPS 和子域策略后再加长。若出现重定向循环,检查 CDN 回源协议、X-Forwarded-Proto 和 Nginx 的 80 跳转规则是否重复。
证书安装、权限与平滑重载
把 CA 下发的 fullchain.pem 和私钥上传到 /etc/nginx/ssl,不要放在网站根目录。证书文件可 644,私钥必须 600 且属主 root。每次改完先执行 nginx -t,通过后再 reload,避免直接 restart 造成连接中断。下面命令可直接执行:
sudo mkdir -p /etc/nginx/ssl
sudo install -m 644 fullchain.pem /etc/nginx/ssl/fullchain.pem
sudo install -m 600 privkey.pem /etc/nginx/ssl/privkey.pem
sudo nginx -t
sudo systemctl reload nginx
sudo ss -lntp | grep :443
Let’s Encrypt 可用 certbot –nginx -d example.com -d www.example.com 申请并自动改写配置,随后用 systemctl list-timers | grep certbot 检查续期定时器。商业证书在 398 天有效期内也要建立到期提醒。云上 SSL 证书配置若使用 SLB、CDN、WAF,要确认证书绑定域名、监听端口 443、后端协议和 SNI 设置一致;只更新 ECS 上的 Nginx 而忘记云产品证书,仍会出现小程序 HTTPS 握手失败。
部署方式对比:手动证书、Certbot 与云证书托管
手动上传适合 OV、EV 或域名固定的商业证书,可控性强但依赖人工续期;Certbot 适合 DV 和 Let’s Encrypt,90 天有效期必须自动续期;云证书托管适合 SLB、CDN、WAF 和多台 ECS 场景,能集中管理但要注意回源和监听配置。选择时不要只看价格,还要看域名数量、是否通配符、是否多台服务器、是否能自动续期、是否有到期告警。小程序 API 域名通常建议 DV 加自动续期,企业门户再考虑 OV。下表给出对比。
| 方式 | 有效期 | 续期方式 | 适用场景 | 主要风险 |
|---|---|---|---|---|
| 手动商业证书 | 最长 398 天 | 人工上传 | OV、EV、固定域名 | 忘记续期、私钥散落 |
| Certbot | 90 天 | 定时任务自动续期 | DV、单域名、多域名 | 验证失败、定时器未启用 |
| 云证书托管 | 按 CA 签发 | 云平台续期或重新上传 | SLB、CDN、WAF、多 ECS | 只改源站未改云产品 |
无论哪种方式,都要保留私钥备份和证书链文件,记录域名、签发时间、到期时间、部署节点。多台 ECS 建议用配置管理或对象存储分发,避免只更新一台导致负载均衡轮询时报错。证书到期前 30 天完成续期和回归测试,比到期当天排查更可靠。
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- HTTPS配置 · SSL证书安装服务(各种服务器)
常见错误排查:真实报错与定位命令
下面报错在 Nginx SSL 配置中很常见,先按错误定位,不要盲目重装证书。
nginx: [emerg] cannot load certificate ... No such file or directory:路径写错、文件未上传或权限不足,检查 ssl_certificate 绝对路径。SSL_CTX_use_PrivateKey ... key values mismatch:证书与私钥不匹配,用 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5 对比。curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间 CA,Nginx 应配 fullchain.pem,而不是只配站点证书。- 小程序 request:fail ssl handshake error:检查 TLS 1.2、SNI、证书域名、443 安全组、系统防火墙和云负载均衡监听。
nginx: [warn] the “ssl” directive is deprecated:删除 ssl on,改为 listen 443 ssl。
定位命令:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 查看返回链;openssl verify -CAfile chain.pem cert.pem 验证证书链;curl -I https://example.com 看 HTTP 状态和证书错误。301 循环时检查 CDN 回源协议与 X-Forwarded-Proto;443 超时先看安全组、ufw、firewalld 和 ss -lntp 是否有监听。
效果验证与到期监控
配置完成后至少做四层验证:Nginx 语法、端口监听、TLS 握手、业务请求。先执行 curl -I https://example.com 应返回 200 或业务正常状态;再用 openssl s_client 查看证书主题、签发者、有效期和证书链。微信开发者工具和真机都要测试 request 合法域名,确认没有 mixed content,页面内图片、脚本、接口全部为 HTTPS。
curl -I https://example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -subject -issuer -dates
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -checkend 2592000
checkend 2592000 表示检查 30 天内是否到期,返回 not expired 才安全。可把该命令写入监控脚本,配合 cron 或云监控告警。浏览器地址栏应显示锁标识,openssl s_client -tls1_2 可验证 TLS 1.2 握手,TLS 1.3 站点也可单独测试。最后检查 HSTS 是否只对 HTTPS 生效、301 是否只跳一次、证书链是否完整;若使用 CDN,刷新缓存后再次验证边缘节点证书。
常见问题
小程序一定要用 EV 证书吗?
不需要。大多数小程序使用受信任 CA 签发的 DV 证书即可,关键是 HTTPS 可访问、TLS 1.2 及以上、证书域名匹配、证书链完整,并按平台要求配置 request 合法域名;中国大陆服务器通常还需域名备案。
SSL 证书最长有效期是多少?
公开信任 TLS 证书单张最长有效期为 398 天,Let’s Encrypt 免费证书有效期为 90 天。无论商业证书还是免费证书,都应提前 30 天续期并配置到期监控。
通配符证书能覆盖主域名和三级域名吗?
*.example.com 只覆盖 a.example.com 这类一级子域名,不覆盖 example.com,也不覆盖 a.b.example.com。需要主域名时在 SAN 中追加 DNS:example.com,三级域名要单独列 SAN 或另配证书。
Nginx 只配 cert.pem 为什么浏览器和小程序报证书链错误?
因为缺少中间 CA。Nginx 的 ssl_certificate 应指向 fullchain.pem,顺序为站点证书在前、中间 CA 在后;私钥仍指向 privkey.pem,修改后执行 nginx -t 和 systemctl reload nginx。
安全组已放行 443 仍超时怎么办?
继续检查系统防火墙 ufw 或 firewalld、Nginx 是否 listen 443、云负载均衡监听和回源协议、CDN 回源端口、IPv6 解析以及 SNI 是否命中。用 ss -lntp | grep :443 和 curl -v 可快速定位。
HTTP 301 到 HTTPS 后小程序还报错?
小程序请求域名应直接写 https,不要依赖 301 跳转;合法域名不能带路径和端口。还要确认证书 SAN 包含该域名、443 可达、证书链完整,并检查页面是否存在 HTTP 混合内容。