跳到主要内容
ssl证书按装

SSL 证书申请、安装与 HTTPS 配置全流程:小程序与 APP 服务端加密实战

SSL 证书申请、安装与 HTTPS 配置全流程:小程序与 APP 服务端加密实战 — 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 天两级告警,同时保留上一版证书与私钥的备份,便于回滚。

内容审核

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