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 的子域。