跳到主要内容
ssl证书按装

微信小程序 HTTPS 实战:SSL CA 证书申请、安装配置、续费与排错指南

微信小程序 HTTPS 实战:SSL CA 证书申请、安装配置、续费与排错指南 — 微信小程序 HTTPS 实战:SSL CA 证书申请、安装配置、续费与排错指南

问题背景与根因:小程序为什么强制 HTTPS,证书又为何频繁过期

微信小程序对服务器域名有明确要求:request、uploadFile、downloadFile、socket 等合法域名必须使用 HTTPS,且服务端需支持 TLS 1.2 及以上,证书必须由受信任 CA 签发,证书链完整,域名与证书 SAN 匹配。自签名证书、过期证书、缺中间证书都会导致真机报 request:fail ssl hand shake error 或开发者工具提示证书无效。很多站点在 ECS 上只开了 80 端口,或安全组未放行 443,也是常见根因。

另一个高频问题是有效期。公共信任 TLS 证书最长有效期已缩短为 398 天,Apple 与 Chrome 对超期证书会拒绝信任;Let’s Encrypt 免费证书有效期为 90 天,必须自动续费。原文中“默认一年证书”的说法已过时。证书过期、系统时间错误、负载均衡与源站证书不一致、Nginx 只配置了 leaf 证书未配置 fullchain,都会造成浏览器或小程序握手失败。

排查先从链路开始,在任意 Linux 机器执行:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
curl -Iv https://example.com
ss -lntp | grep -E ':80|:443'

第一条命令重点看 Verify return code 是否为 0、证书链是否包含中间 CA;第二条看 TLS 版本与证书主题;第三条确认 443 是否监听。若 Verify return code 为 20 或 21,通常是缺中间证书或证书过期;若 curl 返回 Failed to connect,优先检查 ECS 安全组、云防火墙和本机 firewalld/ufw 是否放行 443。小程序侧还要在微信公众平台“开发管理-服务器域名”中配置 request 合法域名,不能带端口、不能使用 IP、不能使用自签名证书。完成这些背景确认后,再进入证书选型与申请。

证书类型与选型对比:DV、OV、EV 与单域名、多域名、通配符怎么选

CA 证书按验证强度分为 DV、OV、EV。DV 只验证域名控制权,通常几分钟签发,适合个人博客、API、下载站和小程序后端;OV 需验证企业身份,通常 3-5 个工作日;EV 曾以浏览器地址栏显示公司名作为卖点,但主流浏览器已弱化该展示,EV 不再保证地址栏出现公司名称,更多用于金融、电商合规与品牌背书。按覆盖范围分为单域名、多域名(SAN)和通配符。通配符 *.example.com 只覆盖一级子域,不覆盖 example.com,也不覆盖 a.b.example.com。

证书类型 验证内容 签发时间 适用场景 有效期提示
DV 域名 DNS/HTTP 控制权 几分钟至数小时 个人站、小程序 API、测试环境 商业 DV 最长 398 天;Let’s Encrypt 90 天
OV 企业主体 + 域名 3-5 工作日 企业官网、SaaS 最长 398 天,需提前续费
EV 严格企业身份 5-10 工作日 金融、电商合规 最长 398 天,地址栏公司名不保证显示
覆盖类型 示例 是否覆盖
单域名 api.example.com 仅该主机名
多域名 SAN api.example.com、www.example.com 列出的域名
通配符 *.example.com a.example.com,不覆盖 example.com 与 a.b.example.com

选型建议:小程序后端若只有 api.example.com,选单域名 DV 即可;同一证书要覆盖 www、api、m,选多域名 DV;二级子域很多且经常新增,选通配符 DV,但要注意通配符私钥泄露影响面大。企业门户需要展示组织信息,可选 OV;银行、支付、电商可按合规要求选 EV,但不要期待浏览器一定显示公司名。预算有限且能接受 90 天续期,可用 Let’s Encrypt;需要固定有效期和商业支持,选商业 CA。无论哪种,部署时必须使用 fullchain(叶子证书 + 中间证书),私钥权限设为 600,避免把私钥放在 Web 根目录。

申请前准备与完整实操步骤:DNS TXT、CSR、ACME 与云安全组

准备材料:域名管理权限、可用的 DNS TXT 记录、服务器 root 或 sudo 权限、Web 服务类型与版本。ECS 需在安全组放行 80 和 443;80 用于 HTTP-01 验证和 301 跳转,443 用于 HTTPS。若使用 CDN/负载均衡,证书应上传到 CDN/CLB,并确保回源协议与源站证书一致。商业 CA 申请通常提交 CSR;Let’s Encrypt 可用 certbot 自动生成私钥和 CSR。

先生成私钥与 CSR,命令可直接执行:

openssl req -new -newkey rsa:2048 -nodes -keyout /etc/ssl/private/example.com.key -out /etc/ssl/certs/example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'

将 CSR 内容提交给商业 CA,按提示添加 DNS TXT 记录。以 Let’s Encrypt webroot 方式为例,先安装 certbot,再执行:

sudo apt update
sudo apt install -y certbot python3-certbot-nginx
sudo mkdir -p /var/www/html/.well-known/acme-challenge
sudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --email admin@example.com --agree-tos --no-eff-email

若申请通配符证书,必须用 DNS-01。以手动 DNS 为例:

sudo certbot certonly --manual --preferred-challenges dns -d '*.example.com' -d example.com

按输出在 DNS 添加 _acme-challenge.example.com 的 TXT 记录,等待 TTL 生效后回车。生产环境建议使用 certbot-dns-aliyun、certbot-dns-cloudflare 等插件自动写入 TXT,避免手动续期失败。验证 DNS 是否生效:

dig +short TXT _acme-challenge.example.com
curl -I http://example.com/.well-known/acme-challenge/test

证书签发后一般位于 /etc/letsencrypt/live/example.com/,包含 fullchain.pem 与 privkey.pem。商业证书会下发 .crt、.ca-bundle、.key 或 .pfx,部署前用 openssl x509 -in cert.crt -noout -subject -issuer -dates 核对域名和有效期。注意:公共信任证书最长 398 天,Let’s Encrypt 为 90 天,不存在“买一次永久有效”的 CA 证书。

Nginx/Apache/Tomcat/IIS 配置示例:443 监听、证书链与 301 跳转

Nginx 推荐将 80 做 301,443 加载 fullchain。示例:

server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_session_cache shared:SSL:10m;
add_header Strict-Transport-Security 'max-age=31536000' always;
root /var/www/html;
index index.html;
}

执行 nginx -t 后 systemctl reload nginx。Apache 示例:

<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/ssl/certs/example.com.crt
SSLCertificateKeyFile /etc/ssl/private/example.com.key
SSLCertificateChainFile /etc/ssl/certs/example.com.ca-bundle
</VirtualHost>

执行 apachectl configtest 后 systemctl reload httpd 或 apache2。Tomcat 需要 JKS/PKCS12:

openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem -out example.com.p12 -name tomcat -CAfile chain.pem -caname root
keytool -importkeystore -deststorepass changeit -destkeypass changeit -destkeystore example.com.jks -srckeystore example.com.p12 -srcstoretype PKCS12 -srcstorepass YOUR_PASSWORD -alias tomcat

server.xml 中配置 <Connector port=’8443′ protocol=’org.apache.coyote.http11.Http11NioProtocol’ SSLEnabled=’true’ keystoreFile=’/opt/tomcat/conf/example.com.jks’ keystorePass=’changeit’ />。IIS 则导入 .pfx,在“站点绑定”中添加 https:443,选择证书并勾选 SNI。所有平台都要注意:证书文件用 fullchain,私钥不要外泄;云负载均衡监听 443 后,后端可继续用 HTTP,但需在 CLB 上配置证书并开启健康检查。配置完成后用 curl -I http://example.com 应返回 301 Location: https://…,curl -I https://example.com 应返回 200 或业务状态码。

证书续费与自动化:90 天与 398 天证书的续期策略

Let’s Encrypt 证书有效期 90 天,官方建议在到期前 30 天续期;certbot 安装后通常自带 systemd timer 或 cron。先做演练:

sudo certbot renew --dry-run
sudo certbot certificates

生产自动续期并重载 Nginx:

sudo crontab -e
0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'

若使用 systemd,可执行 systemctl list-timers | grep certbot 查看下一次触发。商业 DV/OV/EV 证书最长有效期 398 天,不能依赖“一年一续”的旧习惯,应在到期前 30-45 天完成续费并重新签发,因为续费后 CA 会给出新证书和新序列号。云上证书可在 SSL 证书服务控制台开启到期提醒,CDN/CLB 上传新证书后需检查是否绑定到正确域名和监听端口。续期后验证:

openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -dates -subject -issuer
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates

常见续期失败原因:DNS-01 的 TXT 记录未更新、webroot 路径被 301 跳转拦截、80 端口被安全组关闭、certbot 插件权限不足、CDN 回源到旧证书。若使用通配符证书,必须保留 DNS API 凭据并限制权限;凭据文件建议 chmod 600。续费不是简单“延期”,而是签发新证书,因此要重新部署 fullchain 和私钥,并 reload 服务。对于多台 ECS,建议把证书放在负载均衡统一管理,或使用配置管理工具分发,避免部分节点证书过期造成小程序偶发握手失败。

常见错误排查:真实报错与对应命令

下面按报错定位。先看端口与配置:ss -lntp | grep 443;nginx -t;tail -n 50 /var/log/nginx/error.log。真实报错与处理:

报错/现象 根因 处理命令
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺中间证书,未使用 fullchain ssl_certificate 指向 fullchain.pem;openssl s_client -showcerts 检查链
NET::ERR_CERT_DATE_INVALID 证书过期或系统时间错误 date -u;openssl x509 -noout -dates -in cert.pem;续期并 reload
request:fail ssl hand shake error TLS 版本过低、证书链不全、域名未在公众平台配置 ssl_protocols TLSv1.2 TLSv1.3;检查 SAN;配置 request 合法域名
nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX: no start line 证书路径错误或文件不是 PEM file cert.pem;head -n 1 cert.pem 应为 —–BEGIN CERTIFICATE—–
SSL_ERROR_RX_RECORD_TOO_LONG 443 端口跑的是 HTTP,或 Nginx 未加载 ssl 检查 listen 443 ssl;curl -k https://127.0.0.1:443
curl: (7) Failed to connect to example.com port 443 ECS 安全组/防火墙未放行 443 安全组入方向放行 TCP:443;firewall-cmd –add-service=https –permanent
403 Forbidden /.well-known/acme-challenge/ webroot 权限或 301 跳转拦截验证 chmod -R 755 /var/www/html;为 /.well-known 放行 HTTP

若浏览器提示“证书名称不匹配”,用 openssl x509 -in fullchain.pem -noout -text | grep -A1 ‘Subject Alternative Name’ 检查 SAN 是否包含实际访问域名。若只有 example.com 却访问 www.example.com,需要重新签发多域名证书。若小程序真机失败但浏览器正常,重点检查 TLS 1.2、证书链、SNI 和域名备案/合法域名配置。排查时不要只看“证书已安装”,要用 openssl s_client 看服务端实际下发的链,用 curl -Iv 看握手结果,用 ss 看监听端口,三者结合才能定位。

效果验证与上线检查:从 301 到证书链的验收清单

上线前执行以下命令,结果应可复现:

curl -I http://example.com
curl -I https://example.com
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep -E 'Verify return code|Protocol|Cipher'
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -subject -issuer -dates
curl -sS https://example.com | grep -i 'http://' | head

验收标准:HTTP 返回 301 且 Location 为 https://example.com/…;HTTPS 返回 200/204/业务正常状态;Verify return code 为 0;TLS 1.2 与 TLS 1.3 均可握手;证书 SAN 覆盖实际域名;有效期大于 30 天;页面无混合内容,即没有 http:// 的图片、脚本、接口。若使用 HSTS,首次上线不要直接设置 includeSubDomains 和 preload,先观察所有子域是否都支持 HTTPS。小程序侧在微信开发者工具中打开“不校验合法域名”仅用于本地调试,真机必须使用已配置的 HTTPS 域名。云上架构还要检查 CLB/CDN 证书是否与源站一致、回源协议是否为 HTTPS、健康检查是否命中 443。最后用 SSL Labs 或 openssl 做一次外部视角检查,确认证书链、协议和加密套件符合要求。验收通过后记录证书到期时间,并把续期任务加入监控。

常见问题

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

不必须。微信小程序要求 HTTPS 和受信任 CA 证书,DV 证书即可满足,只要域名已配置为 request 合法域名、证书链完整、TLS 1.2 以上。OV/EV 主要用于企业身份展示和合规场景。

Let’s Encrypt 免费证书能用于小程序吗?

可以。Let’s Encrypt 是公共信任 CA,证书被主流浏览器和微信客户端信任。但有效期 90 天,必须配置自动续期和 reload,否则过期后小程序会握手失败。

证书最长有效期到底是多久?

公共信任 TLS 证书最长 398 天,商业 CA 通常按 398 天签发;Let’s Encrypt 为 90 天。原文“默认一年”已过时,续费应提前 30 天左右。

通配符证书能覆盖三级域名吗?

不能。*.example.com 只覆盖 a.example.com,不覆盖 example.com,也不覆盖 a.b.example.com。需要把主域名加入 SAN 或单独申请证书。

ECS 安全组已放行 443,为什么仍无法访问?

还要检查本机 firewalld/ufw、Nginx 是否 listen 443 ssl、云防火墙和负载均衡监听。用 ss -lntp | grep 443 与 curl -k https://127.0.0.1 分层排查。

续费后需要重启服务器吗?

不需要重启整机,但必须 reload Web 服务使新证书生效,例如 systemctl reload nginx。若使用 CLB/CDN,要重新上传并绑定新证书。

内容审核

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