SSL 证书申请、安装与 HTTPS 配置全流程:小程序与 APP 服务端加密实战
一、问题背景与根因:小程序与 APP 为什么必须上 HTTPS
微信小程序自诞生起就强制要求网络请求走 HTTPS:wx.request 只接受 https:// 开头的地址,域名必须先在微信公众平台「开发管理 → 服务器域名」中登记为 request 合法域名,服务端 TLS 版本不得低于 1.2,必须使用 443 端口,不支持 IP 地址与自签名证书。iOS 的 App Transport Security(ATS)默认禁止明文 HTTP;Android 9(API 28)起 cleartextTrafficPermitted 默认为 false。换言之,一条完整可信证书链缺失的服务器,在这三类客户端上会直接不可用。
线上最常见的故障并不是「证书没买」,而是部署层面的四类问题:
- 只部署了服务器证书(server certificate),漏装中间证书(intermediate),导致证书链不完整;
- 证书 SAN 里没有实际访问的域名,例如只签了
example.com,却用www.example.com或api.example.com访问; - 服务端仍启用 TLS 1.0/1.1,或加密套件中缺少客户端支持的 ECDHE 系列;
- 同一 IP 承载多个站点却没有启用 SNI,握手时返回了错误站点的证书。
对应的真实报错:小程序端 request:fail ssl handshake error、errCode: -1;Chrome 端 NET::ERR_CERT_AUTHORITY_INVALID、NET::ERR_CERT_COMMON_NAME_INVALID;命令行 curl: (60) SSL certificate problem: unable to get local issuer certificate。只要看到 unable to get local issuer certificate,基本可以直接判定为中间证书缺失,后文排查章节会给出定位命令。理解根因后再动手,比盲目重签一张证书有效得多。
二、选型先行:DV/OV/EV 与单域名/多域名/通配符
证书的「验证强度」和「域名覆盖范围」是两个正交维度,必须分别确定。先看验证强度:
| 类型 | 验证内容 | 典型签发时长 | 浏览器表现 | 适用场景 |
|---|---|---|---|---|
| DV 域名型 | 仅验证域名控制权(DNS TXT 或 HTTP 文件) | 1-10 分钟 | 普通锁标识 | 个人站、API 网关、小程序后端 |
| OV 企业型 | 额外核验工商注册信息 | 1-3 个工作日 | 普通锁标识,可查组织名 | 企业官网、对外业务门户 |
| EV 增强型 | 严格企业身份与法律存在性审核 | 3-7 个工作日 | 普通锁标识,可查组织名 | 金融、电商、需合规背书 |
再看覆盖范围:
| 覆盖类型 | 示例 | 关键限制 |
|---|---|---|
| 单域名 | example.com | 不含 www,不含任何子域 |
| 多域名(SAN) | example.com、a.com、b.net | 一般可放 1-100 个,可后期追加 |
| 通配符 | *.example.com | 只覆盖一级子域,不含 example.com 本身,也不含 a.b.example.com |
两点必须纠正的过时说法。其一,CA/Browser Forum 规定自 2020-09-01 起,公开信任的 TLS 证书单张最长有效期不得超过 398 天,市面上「买一年」的商业证书实际签发的是 398 天以内,且每年需重签;Let’s Encrypt 固定 90 天。该上限后续还将继续缩短(2026 年 3 月起 200 天、2027 年起 100 天),因此续期必须自动化,不能依赖人工记忆。其二,Chrome 77(2019 年 9 月)起已移除 EV 证书在地址栏展示公司名的绿色标识,现在只能点击地址栏锁图标查看组织信息,EV 的实际价值转移到了合规审计与证书保险,而非视觉差异。
选型建议:个人博客、内部 API、小程序后端一律 DV 足够;对外企业门户若采购方要求提供组织信息,选 OV;金融、支付类有明确合规条款要求时再上 EV。
三、实操第一步:生成私钥与 CSR(含 ECDSA 方案)
CSR(证书签名请求)必须在最终部署的服务器上或受控环境中生成,私钥绝不能外发。以下命令在 OpenSSL 1.1.1+ 环境可直接执行:
# 1. 生成 RSA 2048 私钥(兼容性最好,IIS/Tomcat 老版本也能用)
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
# 2. 生成 CSR,务必带上 SAN;CN 字段主流 CA 已忽略
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com'
# 3. 本地校验 CSR
openssl req -in example.com.csr -noout -verify
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
如果服务端是 Nginx 1.11+、Tomcat 8.5+ 等新版本,可改用 ECDSA P-256,握手更快、证书更小:
openssl ecparam -genkey -name prime256v1 -out example.com.ec.key
openssl req -new -key example.com.ec.key -out example.com.ec.csr
-subj '/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
若 OpenSSL 为 1.0.2(CentOS 7 默认版本),不支持 -addext,需写配置文件:
cat > san.cnf <<'EOF'
[req]
distinguished_name = dn
req_extensions = v3_req
[dn]
[v3_req]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
DNS.3 = api.example.com
EOF
openssl req -new -key example.com.key -out example.com.csr -config san.cnf -subj '/CN=example.com'
三个高频坑:①通配符 *.example.com 不会覆盖裸域 example.com,必须同时写两条 SAN;②域名大小写、末尾点号都会导致匹配失败,统一用小写无点号形式;③私钥一旦泄露只能吊销重签,不要通过聊天工具传输 .key 文件。
四、实操第二步:域名验证与证书签发
CA 通过域名控制权验证确认申请者对域名的所有权,DV 证书常用两种方式。
方式一:DNS TXT 记录。CA 会给出主机记录(如 _dnsauth.example.com)和记录值,在 DNS 服务商添加后验证:
dig +short TXT _dnsauth.example.com
# 期望输出类似:"2025011500000abcdef1234567890abc"
注意 DNS 生效受 TTL 影响,修改后可用 dig @8.8.8.8 TXT _dnsauth.example.com 与权威 NS 交叉验证,避免递归缓存返回旧值。
方式二:HTTP 文件。把 CA 提供的文件放到站点根目录下的固定路径,需保证 80 端口可被公网访问且不被 301 跳转到 HTTPS:
mkdir -p /var/www/html/.well-known/pki-validation
curl -I http://example.com/.well-known/pki-validation/xxxx.txt
# 必须返回 HTTP/1.1 200,返回 301 会导致验证失败
方式三:ACME 自动化(Let’s Encrypt,90 天有效期)。推荐生产环境直接使用:
# 通配符必须走 DNS-01,需要 DNS API 插件或手动添加 TXT
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com -d api.example.com
--email ops@example.com --agree-tos --no-eff-email
# 通配符(交互式,或配合 certbot-dns-aliyun 等插件全自动)
certbot certonly --manual --preferred-challenges dns
-d '*.example.com' -d example.com
# 验证续期链路是否通畅
certbot renew --dry-run
签发完成后,CA 返回的压缩包里通常有四个文件:example.com.crt(服务器证书)、ca_bundle.crt 或 intermediate.crt(中间证书)、example.com.key(私钥)、example.com.csr。真正要部署到服务端的是「服务器证书 + 中间证书」拼接成的 fullchain,顺序不能反。
五、配置示例:Nginx 与 Apache 的 TLS 落地
先拼接并校验证书链:
cat example.com.crt intermediate.crt > fullchain.pem
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
# 应输出两张证书:subject=example.com,subject=中间 CA
Nginx 完整配置(TLS 1.2/1.3 + HSTS + OCSP Stapling):
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
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_trusted_certificate /etc/nginx/ssl/intermediate.crt;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 8.8.8.8 valid=300s;
add_header Strict-Transport-Security max-age=31536000 always;
location / { proxy_pass http://127.0.0.1:8080; }
}
Apache 2.4.8+ 只需把 SSLCertificateFile 指向 fullchain 即可,不再单独配置 ChainFile:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# Apache 2.4.8 之前才需要:SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
Header always set Strict-Transport-Security max-age=31536000
</VirtualHost>
改完执行 nginx -t && nginx -s reload 或 apachectl configtest && systemctl reload httpd。HSTS 一旦下发,浏览器在 max-age 内会强制 HTTPS,建议先用较短 max-age(如 300 秒)验证,再调到一年。
六、配置示例:Tomcat 与 IIS 的证书部署
Java 生态不直接读 PEM,需要转 JKS/PKCS12:
# PEM → PKCS12
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-out example.com.p12 -name tomcat -passout pass:ChangeIt123
# PKCS12 → JKS
keytool -importkeystore -srckeystore example.com.p12 -srcstoretype PKCS12
-srcstorepass ChangeIt123 -destkeystore example.com.jks -deststoretype JKS
-deststorepass ChangeIt123 -destkeypass ChangeIt123
# 校验:必须能看到完整链,长度 >= 2
keytool -list -v -keystore example.com.jks -storepass ChangeIt123 | grep -E 'Alias|Certificate chain length|Valid'
Tomcat conf/server.xml 中的 Connector:
<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol'
maxThreads='200' SSLEnabled='true' scheme='https' secure='true'
keystoreFile='/opt/tomcat/conf/example.com.jks' keystorePass='ChangeIt123'
clientAuth='false' sslProtocol='TLSv1.2,TLSv1.3' />
若 keytool -list 显示 chain length 为 1,说明导入时只带了服务器证书,小程序端会直接握手失败,必须重新用 fullchain 生成 PKCS12。
IIS 流程:①certlm.msc 打开计算机证书管理,在「个人 → 证书」右键「导入」选择 .pfx,勾选「允许导出私钥」并按需设置密码;②中间证书单独导入到「中间证书颁发机构 → 证书」,否则部分 Android 客户端会报链不完整;③站点「绑定 → 添加 → https → 443」,选择证书并勾选 SNI(多站点共用 IP 必须勾选);④若使用 PFX 密码保护,需在导入时选择「标记此密钥为可导出」以便后续备份。完成后用 netsh http show sslcert 确认绑定关系。
七、客户端侧:小程序与 APP 的 HTTPS 合规配置
服务端配好只是第一步,客户端侧的强制策略同样会导致请求失败。
微信小程序硬性要求:域名已 ICP 备案、HTTPS、TLS ≥ 1.2、443 端口、不支持自签名证书、不支持 IP。配置入口在「微信公众平台 → 开发管理 → 开发设置 → 服务器域名 → request 合法域名」,每月可修改次数有限,改前务必确认。常见报错:request:fail url not in domain list(域名未登记)、request:fail ssl handshake error(证书链或 TLS 版本问题)、errCode: -1(多为握手失败或证书过期)。开发者工具里可用「详情 → 域名信息」直接查看服务端证书链,比猜快得多。
Android 从 9.0 起默认禁止明文流量,推荐显式声明网络安全配置:
<!-- res/xml/network_security_config.xml -->
<network-security-config>
<base-config cleartextTrafficPermitted='false'>
<trust-anchors><certificates src='system' /></trust-anchors>
</base-config>
<domain-config cleartextTrafficPermitted='false'>
<domain includeSubdomains='true'>example.com</domain>
</domain-config>
</network-security-config>
并在 AndroidManifest.xml 的 <application> 上加 android:networkSecurityConfig='@xml/network_security_config'。若忽略,典型报错为 java.io.IOException: Cleartext HTTP traffic to api.example.com not permitted。
iOS 的 ATS 默认要求 TLS 1.2+ 且使用支持前向保密的套件,报错为 NSURLErrorAppTransportSecurityRequiresSecureConnection (-1022)。正确做法是修服务端而不是加 NSAllowsArbitraryLoads——后者在 App Store 审核时需要提供合理理由。若确有自建 CA 的测试环境,使用 NSAllowsLocalNetworking 或将根证书预置到 NSPinnedDomains 做证书固定。
八、常见错误排查:真实报错与定位命令
| 报错信息 | 根因 | 定位/修复 |
|---|---|---|
curl: (60) SSL certificate problem: unable to get local issuer certificate |
缺中间证书,链不完整 | ssl_certificate 必须指向 fullchain.pem |
NET::ERR_CERT_COMMON_NAME_INVALID |
SAN 中无当前域名 | 重签并加入该域名,或用正确域名访问 |
NET::ERR_CERT_DATE_INVALID |
证书过期或服务器时间偏差 | timedatectl 校时 + 续期 |
nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
证书与私钥不配对 | 见下方 modulus 比对 |
nginx: [emerg] bind() to 0.0.0.0:443 failed (98: Address already in use) |
443 被占用或旧进程未退出 | ss -lntp | grep :443 |
SSL_ERROR_NO_CYPHER_OVERLAP / ERR_SSL_VERSION_OR_CIPHER_MISMATCH |
协议或套件交集为空 | 至少保留 TLSv1.2 + ECDHE 套件 |
小程序 request:fail ssl handshake error |
链不完整 / TLS 1.2 未开 / 用了自签 | 用 ssllabs 或开发者工具查链 |
证书与私钥是否配对,用模数指纹比对,两条命令输出必须完全一致:
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
确认服务端到底返回了几张证书:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -E '^ *[0-9]+ s:'
输出只有 1 行(如 0 s:example.com)说明中间证书没发出去;正常应有 2 行以上,第二行是中间 CA。若线上配置无误但仍报错,检查是否有多层代理(CDN、WAF、负载均衡)在中间终止了 TLS 并返回了旧证书。
九、效果验证与证书生命周期管理
部署完成后按四步验证,全部通过才算真正生效:
# 1. 证书主题、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. 强制用 TLS 1.1 连接,应当失败(说明旧协议已关闭)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 3. 加密套件与协议枚举
nmap --script ssl-enum-ciphers -p 443 example.com
# 4. 小程序侧等价验证:确认 HTTP/2 与 200
curl -sSI https://example.com | head -3
剩余天数监控脚本(低于 30 天告警):
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 ))
echo "example.com 证书剩余 ${days} 天"
[ "$days" -lt 30 ] && echo 'WARN: 证书即将到期' | mail -s 'SSL 告警' ops@example.com
续期侧:Let’s Encrypt 由 systemd timer 自动执行 certbot renew,用 systemctl list-timers | grep certbot 确认定时器存活,并配置 deploy-hook 在续期后重载服务:
certbot renew --quiet --deploy-hook 'systemctl reload nginx'
商业证书有效期上限为 398 天,必须在到期前 30 天启动重签并替换 fullchain;注意重签会生成新私钥,替换时证书与私钥要成对更新,否则会触发上一节的 key values mismatch。最后用 SSL Labs(ssllabs.com/ssltest)跑一次完整评级,目标为 A 及以上,重点看 Certificate Chains、Protocols、Cipher Suites 三项是否全绿。
常见问题
一张通配符证书能覆盖所有子域名吗?
不能完全覆盖。*.example.com 只匹配一级子域,如 api.example.com、www.example.com,但不匹配裸域 example.com,也不匹配二级子域 a.b.example.com。实际申请时通常需要把 example.com 与 *.example.com 同时写入 SAN。
证书买的是「一年」,为什么实际只有 398 天?
CA/Browser Forum 规定自 2020-09-01 起,公开信任的 TLS 证书单张最长有效期不得超过 398 天。服务商按年售卖的是服务周期,实际签发的是 398 天以内的证书,到期需重新签发。Let’s Encrypt 则固定 90 天,更适合配合 certbot 全自动续期。
小程序提示 request:fail ssl handshake error,但浏览器访问正常怎么办?
浏览器对证书链的容错比小程序严格度不同:浏览器可能自动补全中间证书,而小程序的网络库不会。先在微信开发者工具「详情 → 域名信息」查看服务端返回的证书数量,若只有一张,把 Nginx 的 ssl_certificate 改为 fullchain.pem(服务器证书 + 中间证书拼接)即可。其次确认服务端未禁用 TLS 1.2。
部署 HTTPS 后网站变慢,是证书的问题吗?
通常不是。TLS 握手开销可通过 ssl_session_cache shared:SSL:10m、ssl_session_tickets 与 TLS 1.3 的 0-RTT 抵消。若确实变慢,先检查是否因 HSTS 或 301 跳转导致多次往返,以及 OCSP Stapling 是否因 resolver 配置错误而超时(可临时关闭 ssl_stapling 对比测试)。
能否用 IP 地址申请证书给 APP 接口使用?
公网信任的 CA 基本不再签发 IP 地址证书(仅少数付费产品支持,且价格高、验证繁琐)。小程序明确不支持 IP 直连,必须绑定已备案域名。内网测试环境可自建 CA,但需要在 Android 的 network_security_config 与 iOS 的信任设置中手动导入根证书,且不能用于 App Store 上架的生产包。
证书到期当天续期来得及吗?
不建议。DNS 缓存、CDN 节点证书同步、客户端证书缓存都会带来延迟,且续期失败需要时间排查。工程实践是到期前 30 天自动续期,并在监控中设置 30 天与 7 天两级告警,同时保留上一版证书与私钥的备份,便于回滚。