跳到主要内容
SSL 证书付费服务

小程序 HTTPS 实战:SSL 证书申请、Nginx/Apache/Tomcat/IIS 配置与故障排查

小程序 HTTPS 实战:SSL 证书申请、Nginx/Apache/Tomcat/IIS 配置与故障排查 — 小程序 HTTPS 实战:SSL 证书申请、Nginx/Apache/Tomcat/IIS 配置与故障排查

一、问题背景与根因:小程序、iOS 与广告劫持为什么都指向 HTTPS

微信小程序对网络请求有三条硬约束:请求域名必须是 https;TLS 版本不低于 1.2;证书必须由受信任的 CA 签发,自签名证书和“用户点击继续”的例外在真机上直接被拒绝。iOS 的 ATS(App Transport Security)同样默认要求 TLS 1.2 及以上与前向保密套件;Android 9 以后 cleartextTrafficPermitted 默认为 false,明文请求直接抛 java.io.IOException: Cleartext HTTP traffic to api.example.com not permitted。浏览器侧的 HTTP/2、HTTP/3 也只在 TLS 上协商。

广告劫持的根因更直接:HTTP 是明文,链路上的运营商缓存、公共 Wi-Fi 网关、甚至家用路由器都能在响应 HTML 里插入 <script> 或替换下载链接。开启 HTTPS 后中间人无法伪造证书(除非终端主动忽略告警),注入链路被切断——这就是“苹果防广告劫持”说法的技术来源。

改造前先用三条命令确认站点现状,再决定范围:

curl -sI http://www.example.com | head -3
curl -svo /dev/null https://www.example.com 2>&1 | grep -E 'SSL connection|TLSv'
openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

若输出出现 SSL connection using TLSv1.0,说明协议过低,iOS 与小程序都会失败;若 issuer 显示自建 CA,或 subject 与域名不一致,则证书本身不可用。改造目标可归纳为四条主线:域名匹配(含 SAN)、证书链完整、只开 TLS 1.2/1.3、全站 301 且无混合内容。后文所有配置与排查都围绕这四点展开。

二、证书选型与有效期规则:398 天、90 天,以及已经退场的赛门铁克

原文主打的“赛门铁克(Symantec)SSL 证书”必须纠正:Symantec 的证书业务已于 2017 年被 DigiCert 收购,2018 年起 Chrome/Firefox 对旧 Symantec 根证书不再信任,Symantec 品牌证书已停止签发。当前可选 DigiCert、GlobalSign、Sectigo、TrustAsia 等商业 CA,或 Let’s Encrypt、云厂商免费 DV 证书。原文的“1 年单域名证书”也已不符合现行规则。

有效期现状:公有 CA 签发的单张证书最长 398 天(2020-09-01 起生效,超期证书浏览器直接拒绝);Let’s Encrypt 固定 90 天,官方建议剩余 30 天自动续期;阿里云、腾讯云的免费 DV 额度已调整为 3 个月有效期的个人测试证书,不再是一年。CA/Browser Forum 第 SC-081 号 ballot 已确定继续缩短:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天,因此“买一年省事”的思路必须换成自动化续期。

证书类型 校验方式 典型有效期 小程序/ATS 兼容 适用场景
DV 单域名 DNS 或文件验证域名所有权 90 天(Let’s Encrypt)~398 天(商业) 兼容 小程序后端、API、内部系统
DV 通配符 *.example.com 仅支持 DNS-01 90~398 天 兼容,仅覆盖一级子域 多子域统一部署
OV / EV 企业实名 + 电话核验 最长 398 天 兼容 对外品牌站、支付类
自签名 无 自定义 不兼容 仅内网联调

选型结论:小程序、H5、开放 API 用 DV 足够,关键在链完整与自动续期;证书绑定域名而非 IP,换服务器、换公网 IP 都不需要重签,只要把同一份证书和私钥部署过去即可。通配符证书只匹配一级子域,*.example.com 不覆盖 a.b.example.com,多级子域要写进 SAN。

三、实操第一步:生成私钥与 CSR(必须写 SAN,命令可直接执行)

CSR 中的 SAN 决定证书能覆盖哪些域名,CN 字段在现代浏览器与小程序中已被忽略,只有 SAN 生效。以下命令 CentOS/Ubuntu 通用:

mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
chmod 600 example.com.key
openssl req -new -key example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co.,Ltd/CN=www.example.com' -addext 'subjectAltName=DNS:www.example.com,DNS:example.com'

如需 ECDSA(握手更快,TLS 1.3 下推荐):openssl ecparam -genkey -name prime256v1 -out example.com.key,CSR 命令不变。注意部分老版本 OpenSSL(1.0.2)不支持 -addext,需改用 -config 配合 [v3_req] 段。若服务器是 IIS 或要在云控制台申请,把 .csr 全文贴入即可,私钥永远不外传。

生成后必须做两项自检,否则签发环节必然出错:

openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
openssl pkey -in example.com.key -pubout -outform DER | sha256sum
openssl req -in example.com.csr -pubkey -noout | openssl pkey -pubin -outform DER | sha256sum

两条 sha256sum 输出必须完全一致,才能证明 CSR 与私钥配对。常见错误是复制粘贴时丢掉 -----BEGIN CERTIFICATE REQUEST----- 首尾行,CA 控制台会提示 CSR 格式错误;另一类是把 CN 写成 IP 或带协议头的 https://www.example.com,签发出来域名不匹配。私钥建议离线备份,续期时沿用同一私钥可避免重新部署到多台服务器。

四、实操第二步:签发证书并校验证书链完整性

免费自动签发推荐 certbot(acme.sh 同理):

apt install -y certbot
certbot certonly --webroot -w /var/www/html -d www.example.com -d example.com --email ops@example.com --agree-tos --no-eff-email --keep-until-expiring

产物位于 /etc/letsencrypt/live/www.example.com/:cert.pem(站点证书)、chain.pem(中间证书)、fullchain.pem(两者拼接,Web 服务器用这个)、privkey.pem(私钥)。商业证书下载包通常是 domain.crt + ca-bundle.crt(或 intermediate.crt),必须合并,顺序为站点证书在前、中间证书在后:

cat domain.crt ca-bundle.crt > example.com.fullchain.pem
openssl crl2pkcs7 -nocrl -certfile example.com.fullchain.pem | openssl pkcs7 -print_certs -noout

链校验两条命令:

openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

第一条输出 cert.pem: OK 才算链正确;第二条应返回 ≥2(站点证书 + 中间证书),只返回 1 说明漏装中间证书——这是 Android 与小程序提示“证书不受信任”的最常见原因。根证书不要放进 fullchain(IIS 导入的 pfx 除外,它需要完整链)。自动续期用一条 cron 搞定:

echo '0 3 * * * root /usr/bin/certbot renew --quiet --deploy-hook "systemctl reload nginx"' >/etc/cron.d/certbot-renew

五、配置示例:Nginx / Apache / Tomcat / IIS 四套可直接套用的模板

四套配置的共同原则:证书用“站点证书 + 中间证书”的 fullchain;私钥权限 600;只开 TLS 1.2/1.3;80 端口 301 到 443;HSTS 在验证通过后再加,避免回滚困难。

Nginx(nginx -v ≥ 1.25.1 用 http2 on;,旧版本改为 listen 443 ssl http2;):

server {
    listen 80;
    server_name www.example.com example.com;
    return 301 https://www.example.com$request_uri;
}
server {
    listen 443 ssl;
    http2 on;
    server_name www.example.com example.com;
    ssl_certificate     /etc/ssl/certs/example.com.fullchain.pem;
    ssl_certificate_key /etc/ssl/private/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/ssl/certs/example.com.chain.pem;
    resolver 223.5.5.5 119.29.29.29 valid=300s;
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

执行 nginx -t && systemctl reload nginx。ssl_trusted_certificate 必须指向中间证书(chain.pem),OCSP stapling 才会生效。

Apache 2.4.8+ 只需 SSLCertificateFile 指向 fullchain,不再需要 SSLCertificateChainFile:

<VirtualHost *:443>
    ServerName www.example.com
    SSLEngine on
    SSLCertificateFile    /etc/ssl/certs/example.com.fullchain.pem
    SSLCertificateKeyFile /etc/ssl/private/example.com.key
    SSLProtocol           all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite        ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

Tomcat 9/10 用 PKCS12 最省事:

openssl pkcs12 -export -in example.com.fullchain.pem -inkey example.com.key -name tomcat -out example.com.p12 -passout pass:ChangeIt
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true'>
  <SSLHostConfig protocols='TLSv1.2,TLSv1.3'>
    <Certificate certificateKeystoreFile='/opt/tomcat/conf/example.com.p12'
                 certificateKeystorePassword='ChangeIt'
                 certificateKeystoreType='PKCS12' />
  </SSLHostConfig>
</Connector>

IIS:导入 pfx 时必须勾选“包含所有证书”,或在管理员 CMD 执行 certutil -addstore -f CA chain.crt 补中间证书;站点绑定 443 并勾选 SNI;跳转用 URL Rewrite:

<rule name='Redirect to https' stopProcessing='true'>
  <match url='(.*)' />
  <conditions><add input='{HTTPS}' pattern='off' /></conditions>
  <action type='Redirect' url='https://{HTTP_HOST}/{R:1}' redirectType='Permanent' />
</rule>

六、对比表格:四种服务器配置差异与证书获取方式取舍

先横向对比服务器侧,重点看“链怎么给”和“怎么生效”,这是迁移和排障时最容易踩空的两列:

Web 服务器 证书文件要求 是否单独配链 80→443 跳转 生效命令 高频坑
Nginx fullchain.pem + key 否,链写在 ssl_certificate return 301 nginx -t && systemctl reload nginx 只配 cert.pem 导致链缺失
Apache 2.4.8+ fullchain.pem + key 否(旧版用 SSLCertificateChainFile) Redirect permanent apachectl configtest && systemctl reload httpd 照抄旧教程重复配链
Tomcat 9/10 PKCS12(.p12) 否,p12 内含链 Nginx 前置或 security-constraint systemctl restart tomcat alias 名与配置不一致
IIS 10 PFX(含中间证书) 是,需导入中间 CA URL Rewrite 规则 iisreset pfx 缺链,安卓不信任

再对比证书获取方式。小程序只校验域名与链完整性,不区分 DV/OV,所以成本主要买的是有效期与人工服务,而不是“兼容性”:

获取方式 有效期 成本 自动续期 小程序可用 适用场景
Let’s Encrypt(certbot/acme.sh) 90 天 免费 原生支持,cron 续期 可用 绝大多数业务首选
云厂商免费 DV 3 个月 免费额度 需手动或调 API 可用 测试环境、临时域名
商业 DV 最长 398 天 数百元/年 不支持,需人工换签 可用 不便维护 ACME 的团队
商业 OV / EV 最长 398 天 数千元/年 不支持 可用 金融、政企对外站点

结论:只要链完整、TLS ≥1.2、域名匹配,免费证书与付费证书在小程序里的表现没有差别。付费买的是有效期长度与人工兜底,而随着 398 天逐步缩短到 200/100/47 天,自动续期能力比证书品牌更重要。

七、常见错误排查:六条真实报错与对应修复命令

1. curl: (60) SSL certificate problem: unable to get local issuer certificate
链不完整,客户端拿不到中间证书。用 openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts 数返回张数,少于 2 张就重新合并 fullchain 并检查 Nginx 是否误配了 cert.pem。

2. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID,curl 提示 subjectAltName does not match
SAN 未覆盖访问的域名。典型是只签了 example.com 却用 www.example.com 访问,或通配符证书拿去访问二级子域。用 openssl x509 -in cert.pem -noout -ext subjectAltName 核对。

3. nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥与证书不配对,多为续期后只替换了其中一个文件。用第三节的两条 sha256sum 命令比对公钥指纹。

4. PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line)
文件不是 PEM:可能是 DER 格式,或从 Windows 传过来带 CRLF/BOM。用 file cert.crt 判断,DER 转 PEM 用 openssl x509 -inform DER -in cert.crt -out cert.pem,换行问题用 sed -i 's/r$//' cert.pem。

5. 小程序真机 request:fail ssl hand shake error
握手失败,常见于只开了 TLS 1.3、只配了 ECDSA 证书,或旧 Android 不支持对应套件。用 openssl s_client -connect www.example.com:443 -servername www.example.com -tls1_2 复测;生产环境建议 RSA 2048 与 ECDSA 双证书,或至少保证 RSA 2048 + TLS 1.2 可用。

6. curl: (35) error:1408F10B:SSL routines:ssl3_get_record:wrong version number
443 端口上跑的不是 TLS:可能是 Nginx 未 reload、后端反向代理指到了 80 端口,或 CDN 回源协议配成了 HTTP。用 ss -lntp | grep 443 与 curl -sI https://www.example.com 交叉确认。

另外两类不报错但会被判“不安全”的问题:Tomcat 报 java.io.IOException: Alias name [tomcat] does not identify a key entry,用 keytool -list -v -keystore example.com.p12 -storetype PKCS12 核对 alias;页面出现 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure element 'http://...',说明资源仍写死 http,可加 add_header Content-Security-Policy "upgrade-insecure-requests" always; 或改为协议相对地址。

八、效果验证:上线前必跑的五组检查

第一组看证书本身:

openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

确认 subject 含访问域名、issuer 为公有 CA、notAfter 在有效期内且不超过 398 天。

第二组探测协议与套件,期望 TLS 1.0/1.1 失败、1.2/1.3 成功:

for v in tls1_1 tls1_2 tls1_3; do echo -n "$v: "; openssl s_client -connect www.example.com:443 -servername www.example.com -$v </dev/null >/dev/null 2>&1 && echo OK || echo FAIL; done

第三组验证跳转与协议协商:

curl -sI http://www.example.com | grep -i '^location'
curl -s -o /dev/null -w '%{http_code} %{http_version}n' https://www.example.com

期望 301 指向 https,且 http_version 为 2(启用 HTTP/2 时)。

第四组做到期监控,把剩余天数接入告警(低于 15 天告警):

end=$(openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2); echo $(( ($(date -d "$end" +%s) - $(date +%s)) / 86400 )) 天

第五组是外部与真机验证:SSL Labs 跑一次应达到 A 及以上,重点看 Certificate Chain、HSTS、OCSP stapling 三项;微信开发者工具“详情 → 域名信息”确认 request 合法域名已配置,再用 iOS 与 Android 各一台真机走完整登录流程。最后检查小程序后台的服务器域名是否包含 www 与非 www 两个形态,避免证书覆盖而域名未备案/未配置导致的 request:fail url not in domain list。

常见问题

小程序必须买付费证书吗?

不必。小程序只校验域名匹配、证书链完整、TLS ≥1.2,Let’s Encrypt 的 90 天 DV 证书和云厂商 3 个月免费证书都可用。真正的风险在续期:免费证书周期短,必须配置 certbot renew 或 acme.sh 定时任务,并加到期监控。

同一张证书能部署到多台服务器、多个域名吗?

证书绑定域名不绑定 IP,同一份证书与私钥可以部署到任意多台服务器(负载均衡、CDN 回源均可)。单域名证书只能用于一个域名;多域名需在 SAN 中列出(一般上限 100 个);通配符 *.example.com 只覆盖一级子域。私钥泄露必须立即吊销并重签。

浏览器显示小锁正常,为什么小程序仍报 SSL 错误?

桌面浏览器可能缓存了中间证书或走 HTTP/2 协商成功,而小程序对链完整性更严格。用 openssl s_client -showcerts 确认服务端返回至少 2 张证书,并检查是否只支持 TLS 1.3 或只配了 ECDSA 证书,导致旧 Android 握手失败。

已经 301 跳到 HTTPS,为什么还有“不安全”提示?

混合内容。页面 HTML 里的图片、JS、CSS 仍写死 http://,浏览器会标记为不安全,小程序里也可能被拦截。用开发者工具 Console 搜索 Mixed Content,把资源改为 // 相对协议或 https 绝对地址,并加 Content-Security-Policy: upgrade-insecure-requests 兜底。

证书应该提前多久续期?

Let’s Encrypt 90 天证书建议剩余 30 天自动续期;398 天的商业证书建议提前 30 天人工换签。按 CA/B Forum SC-081,2026 年起最长有效期降至 200 天、2027 年 100 天、2029 年 47 天,人工续期模式不可持续,应尽早接入 ACME 自动化。

换服务器或换公网 IP 需要重新申请证书吗?

不需要。证书只与域名绑定,迁移时把 fullchain 与私钥一起复制到新机器,确认私钥权限 600、Nginx/Apache 配置路径正确即可。若新环境是多站点共用 443,需确认 SNI 已开启,否则客户端可能拿到默认站点的证书并报域名不匹配。

内容审核

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