跳到主要内容
HTTPS小程序证书

SSL 证书申请与 HTTPS 配置全流程:小程序、APP、公众号、网站通用实战指南(含 Nginx/Apache/Tomcat/IIS)

SSL 证书申请与 HTTPS 配置全流程:小程序、APP、公众号、网站通用实战指南(含 Nginx/Apache/Tomcat/IIS) — SSL 证书申请与 HTTPS 配置全流程:小程序、APP、公众号、网站通用实战指南(含 Nginx/Apache/Tomcat/IIS)

为什么小程序、APP 和公众号必须上 HTTPS:问题背景与根因

很多人的困惑是「网站浏览器能打开,但小程序一直报错」。这不是证书「买没买」的问题,而是证书是否满足客户端更严格的校验规则。微信小程序的 wx.request、wx.uploadFile 只允许 https 请求,请求域名必须在「开发管理 → 服务器域名」中配置,且域名需完成 ICP 备案;微信客户端同时要求服务端支持 TLS 1.2 及以上。iOS 的 ATS(App Transport Security)默认禁止明文 HTTP;Android 9(API 28)起,targetSdkVersion ≥ 28 的应用默认 cleartextTrafficPermitted=false,明文请求直接被系统拦截。公众号网页授权、支付回调、APP 接口同理。

真正导致认证失败的根因集中在五类:自签名证书(客户端不信任)、证书链不完整(只部署了站点证书,没部署中间证书)、域名与证书 SAN 不匹配(用 IP 或 www 访问了只含裸域名的证书)、TLS 版本或加密套件过低(仍开启 TLS 1.0/1.1)、多域名共用同一 IP 时缺少 SNI 支持。

常见真实报错如下,可直接对照排查:

  • 微信开发者工具:request:fail ssl handshake failed
  • Android:javax.net.ssl.SSLHandshakeException: java.security.cert.CertPathValidatorException: Trust anchor for certification path not found.
  • iOS:NSURLErrorDomain Code=-1202 The certificate for this server is invalid
  • Chrome:NET::ERR_CERT_AUTHORITY_INVALID / NET::ERR_CERT_COMMON_NAME_INVALID

术语澄清:SSL 是历史叫法,SSL 3.0 已被 RFC 7568 正式弃用,今天实际运行的是 TLS 1.2 / TLS 1.3,但行业里仍统称「SSL 证书」「服务器证书」。理解这一点很重要——很多「证书装了却不生效」的案例,根源就是协议版本被卡在 TLS 1.0。

域名规划:单域名、多域名与通配符到底怎么算

买证书前必须先算清域名数量,这是最容易多花钱的一步。原文里「abc.com 与 www.abc.com 算 1 个域名」的说法需要修正:从技术上讲它们是两个不同的主机名(Host),严格意义的单域名证书只保护 CSR 中写入的那一个。部分 CA 会把另一个作为赠送 SAN 一并写入,下单前必须确认,否则部署后 www 访问会直接报 ERR_CERT_COMMON_NAME_INVALID。

  • 单域名证书:只保护一个主机名,例如 example.com。m.example.com 属于另一个主机名,需要另买或用通配符。
  • 多域名证书(SAN / UCC):一张证书写入多个不同主机名,例如 example.com、www.example.com、m.example.com、api.example.com 共 4 条,按条数计价,适合域名分散在不同主域的场景。
  • 通配符证书 *.example.com:只覆盖同一级的任意子域(a.example.com、b.example.com),不覆盖 example.com 本身,也不覆盖 a.b.example.com。工程上通常签成 *.example.com + example.com 两条 SAN。
证书类型 覆盖范围 典型场景 参考价格
DV 单域名 1 个主机名 单页站点、测试环境 0~300 元/年
DV 多域名 N 个不同主机名 主站 + API + 后台 按条数叠加
DV 通配符 *.example.com 一级子域 SaaS 多租户、动态子域 600~2000 元/年
OV / EV 同类型,含单位实名审核 金融、政企、支付回调 1000 元/年起

签发后务必核对证书实际覆盖的域名列表,命令:

openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'
# 输出示例:DNS:example.com, DNS:*.example.com

如果这里没有你实际访问的域名,不要继续往下配置,先重新签发,否则后面所有排查都是白费。

申请前的准备:生成私钥与 CSR(可直接执行)

CSR(Certificate Signing Request)是提交给 CA 的证书签名请求,里面包含公钥和主体信息。私钥永远只在你自己服务器上生成和保存,绝不能上传给任何服务商,商业 CA 也只需要 CSR。以下命令在 CentOS/Ubuntu 上均可直接执行。

mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl

# 1) 生成 2048 位 RSA 私钥(ECDSA 见下方备选)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
chmod 600 example.com.key

# 2) 生成 CSR,同时把 SAN 写进去(关键,现代浏览器只看 SAN 不看 CN)
openssl req -new -key example.com.key -sha256 -out example.com.csr 
  -subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example Tech Ltd/OU=IT/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:m.example.com'

# 3) 自检:确认主体与 SAN 正确、签名有效
openssl req -in example.com.csr -noout -subject -verify
openssl req -in example.com.csr -noout -text | head -40

如需 ECDSA 证书(握手更快、体积更小,但部分老旧安卓机不支持,需评估终端分布):

openssl ecparam -genkey -name prime256v1 -out example.com.key

证书签发下来后,第一件事是验证证书与私钥是否配对,这是后续 90% 部署报错的来源:

openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5
# 两行输出的 MD5 必须完全一致,否则证书与私钥不是一对

注意 -nodes 参数在 genpkey 时代已不需要(默认不加密私钥);若给私钥加了密码,Nginx 启动时会每次交互式输入密码,生产环境不要这么做。

证书申请:acme.sh 与 certbot 两条自动化路线

免费证书已足够覆盖小程序、APP、公众号的认证要求(客户端只校验是否被公共信任的 CA 签发、域名是否匹配、链是否完整,与价格无关)。主流方案是 Let’s Encrypt,有效期 90 天,必须自动化续期。

路线一:acme.sh(推荐,支持 DNS-01 与通配符)

curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
acme.sh --set-default-ca --server letsencrypt

# HTTP-01 文件验证(需 80 端口可访问 /var/www/html)
acme.sh --issue -d example.com -d www.example.com -w /var/www/html --keylength ec-256

# 安装证书并配置续期后自动 reload(续期后必须重载才生效)
acme.sh --install-cert -d example.com 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      'systemctl reload nginx'

路线二:certbot

apt install -y certbot python3-certbot-nginx
certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com 
  --deploy-hook 'systemctl reload nginx'
certbot renew --dry-run   # 演练续期,必须返回成功

通配符证书只能用 DNS-01 验证(无法通过 HTTP 文件证明子域控制权):

acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
dig TXT _acme-challenge.example.com +short

有效期规则必须记牢:CA/Browser Forum 规定自 2020-09-01 起,公开信任证书最长有效期 398 天;Let’s Encrypt 为 90 天;按 SC-081 决议,2026-03-15 起降至 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。结论很明确:任何手工记日子续期的流程都会出事,必须走自动化。商业证书申请流程则是:提交 CSR → 选择验证方式(DNS TXT / HTTP 文件 / 邮箱)→ 签发后下载包含中间证书的 fullchain 与私钥文件。

服务器配置示例:Nginx / Apache / Tomcat / IIS

Nginx(最常见,注意 fullchain.pem 的顺序:站点证书在前,中间证书在后)

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-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 1d;

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/fullchain.pem;

    add_header Strict-Transport-Security 'max-age=31536000' always;
    location / { proxy_pass http://127.0.0.1:8080; }
}
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

Apache 2.4

<VirtualHost *:443>
  SSLEngine on
  SSLCertificateFile      /etc/httpd/ssl/fullchain.pem
  SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
  # 2.4.8 之前必须单独指定中间证书
  SSLCertificateChainFile /etc/httpd/ssl/chain.pem
  SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
  SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
</VirtualHost>

Tomcat 9/10(server.xml,直接使用 PEM 格式,无需转 JKS)

<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol' maxThreads='200'>
  <SSLHostConfig protocols='TLSv1.2,TLSv1.3'>
    <Certificate certificateFile='/opt/tomcat/conf/ssl/fullchain.pem'
                 certificateKeyFile='/opt/tomcat/conf/ssl/example.com.key'
                 type='RSA' />
  </SSLHostConfig>
</Connector>

IIS:导入含私钥的 .pfx(「个人」存储)→ 中间证书导入「中间证书颁发机构」→ 站点绑定 443 并勾选 SNI。若拿到的是 PEM,先转换:

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -out example.pfx

证书类型与有效期对比:DV、OV、EV 与 398 天规则

选择证书本质上是在「验证强度」和「覆盖范围」两个维度上做权衡,与加密强度无关——DV、OV、EV 使用的加密算法和密钥长度完全相同,浏览器地址栏的锁标识也相同。

维度 DV 域名型 OV 企业型 EV 扩展验证
验证内容 仅域名控制权 域名 + 单位工商实名 域名 + 单位 + 电话回访等严格核验
签发时长 1 分钟~10 分钟 1~3 个工作日 3~7 个工作日
加密强度 RSA 2048 / ECC 256 同左 同左
小程序 / APP 可用 可以 可以 可以
浏览器地址栏差异 无 无(点开证书可见单位名) 现代浏览器已不再显示绿色公司名
参考价格 0~300 元/年 1000 元/年起 3000 元/年起
有效期规则 上限 说明
CA/B 公开信任证书 398 天 2020-09-01 起生效,2026-03-15 起降为 200 天,2027-03-15 起 100 天
Let’s Encrypt 90 天 免费,支持自动续期,另有短周期证书可选
自签名证书 自定义 任何公共客户端都不信任,小程序/APP 场景不可用

结论:小程序、APP、公众号这类只做机器校验的场景,DV 证书完全够用,把钱花在自动化运维和到期监控上更划算。OV/EV 的价值在于合规审计与对外展示,而非「更安全」。

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

1)curl: (60) SSL certificate problem: unable to get local issuer certificate
原因:证书链不完整,服务器只发了站点证书没发中间证书,常见于把 CA 给的 example.com.crt 直接当 fullchain 用。修复:

cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile fullchain.pem example.com.crt   # 应输出 OK

2)nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
原因:证书与私钥不配对(重新签发后忘了替换私钥)。用前面的 MD5 模数比对命令确认,替换为匹配的一对。

3)nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line)
原因:文件是 DER 或 PFX 格式,不是 PEM。转换:

openssl x509 -inform DER -in cert.der -out cert.pem
openssl pkcs12 -in cert.pfx -nodes -out all.pem

4)浏览器 NET::ERR_CERT_COMMON_NAME_INVALID,微信 request:fail ssl handshake failed
原因:访问的域名不在证书 SAN 列表内(典型:只签了 example.com,却用 www.example.com 或 IP 访问);或服务端只开了 TLS 1.0/1.1。验证:

echo | openssl s_client -connect example.com:443 -servername www.example.com -tls1_2 2>/dev/null | openssl x509 -noout -subject -ext subjectAltName

5)Java 侧 SSLHandshakeException: No subject alternative names present
原因:APP 用 IP 直连,而证书没有 IP 类型的 SAN。IP 证书需在 CSR 中写 IP:203.0.113.10,且部分 CA 不支持签发,建议改用域名。

6)curl: (35) error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure
原因:客户端与服务端没有共同协议或套件(服务端强制了国密/ECC 套件而客户端只支持 RSA)。用 nmap --script ssl-enum-ciphers -p 443 example.com 查看服务端实际支持的套件后对齐配置。

7)NET::ERR_CERT_DATE_INVALID
原因:证书已过期,或服务器系统时间错误(离线克隆的虚拟机常见)。执行 date -u 与 timedatectl status 检查 NTP 同步状态。

效果验证:五条命令确认证书真的生效

配置完不要只看浏览器有没有锁,按下面顺序逐条验证,任何一条不通过都说明还没配好。

# 1. 查看服务端下发的证书主体、签发者与有效期
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 2. 统计下发的证书张数,必须 ≥ 2(站点证书 + 中间证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'

# 3. 校验结果必须为 0(0 表示链校验通过)
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com

# 4. 确认 80 端口已 301 跳转、HSTS 头已下发
curl -sSI http://example.com | grep -i -E 'location|strict-transport'

# 5. 枚举服务端实际启用的协议与套件,确认无 TLSv1.0/1.1
nmap --script ssl-enum-ciphers -p 443 example.com

再补一个到期监控脚本,挂到 cron 每天跑,避免续期失败无人知晓:

#!/bin/bash
END=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $DAYS -lt 15 ] && echo "证书剩余 $DAYS 天,请立即检查续期任务" | mail -s 'SSL 到期告警' ops@example.com

最后在微信开发者工具「详情 → 域名信息」、Android/iOS 真机上各跑一次请求,确认 ssl handshake failed 与 -1202 不再出现,才算真正闭环。国内站点还可用 myssl.com、国际可用 SSL Labs 做一次完整评分,目标 A 级以上。

常见问题

免费的 Let’s Encrypt 证书能用于微信小程序和 APP 吗?

可以。客户端只校验三件事:签发者是否在系统信任库中、域名是否与 SAN 匹配、证书链是否完整。Let’s Encrypt 已被所有主流操作系统与微信、支付宝客户端信任,与 300 元一年的 DV 证书在功能上无差异。区别只在有效期(90 天 vs 最长 398 天)和是否提供人工客服,因此必须配置自动续期与到期告警。

证书装好了浏览器有小锁,但小程序仍报 ssl handshake failed,怎么查?

浏览器容忍度高,小程序容忍度低。按三步排查:① 用 openssl s_client -connect 域名:443 -servername 域名 -showcerts 确认下发证书数 ≥ 2,只有 1 张说明缺中间证书;② 确认服务端已禁用 TLS 1.0/1.1,小程序要求 TLS 1.2+;③ 确认请求域名已在小程序后台「服务器域名」中配置且完成 ICP 备案,未备案的域名无论证书多正确都会被拦。

通配符证书 *.example.com 能覆盖 a.b.example.com 吗?

不能。通配符只匹配一级子域,*.example.com 可覆盖 a.example.com、b.example.com,但不覆盖 example.com 本身,也不覆盖 a.b.example.com。正确做法是签发 *.example.com + example.com 两条 SAN;若确有二级子域需求,需要再买一张 *.b.example.com 或改用多域名证书。

证书续期后需要重启服务器吗?会不会中断业务?

需要重载配置让新证书生效,但不需要重启整机。Nginx 用 systemctl reload nginx(平滑重载,不断连接);Apache 用 systemctl reload httpd;Tomcat 需重启 Connector 所在实例。acme.sh 的 --reloadcmd 和 certbot 的 --deploy-hook 就是为此设计的,务必配置,否则续期成功但线上仍是旧证书,到期当天照样报错。

一台服务器上的多个域名、或多台服务器,能共用一个证书文件吗?

可以。证书与私钥是文件,不绑定机器,只要域名在 SAN 列表中即可复制部署到多台服务器。但要注意两点:私钥分发会扩大泄露面,建议限制文件权限为 600 并做好审计;同一 IP 上承载多个 HTTPS 站点时必须启用 SNI(Nginx 默认开启,Apache 需 SSLStrictSNIVHostCheck off,IIS 绑定时勾选「需要服务器名称指示」),否则客户端可能拿到错误站点的证书。

已经上了 HTTPS,还需要做 HTTP 到 HTTPS 的 301 跳转吗?

需要。用户手输域名、老链接、第三方回调都可能走 http,若不跳转会出现「接口偶发失败」的诡异问题。在 80 端口的 server 块中写 return 301 https://$host$request_uri; 即可(不要用 rewrite,301 更高效且语义正确)。跳转稳定运行一段时间后,再考虑提交 HSTS 头 Strict-Transport-Security: max-age=31536000,注意首次上线不要加 includeSubDomains,避免误伤尚未上 HTTPS 的子域。

内容审核

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