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

APP/小程序 HTTPS 全站加密与 SSL 证书配置实战:签发、部署、续期与排错(2026 版)

APP/小程序 HTTPS 全站加密与 SSL 证书配置实战:签发、部署、续期与排错(2026 版) — APP/小程序 HTTPS 全站加密与 SSL 证书配置实战:签发、部署、续期与排错(2026 版)

一、问题背景与根因:APP/小程序为什么绕不开 HTTPS 与证书链

微信小程序 wx.request、APP 内 WebView、iOS ATS 都要求 HTTPS;iOS 默认要求 TLS 1.2+,Android 7+ 默认不信任用户安装的 CA。线上最常见的证书故障不是“没买证书”,而是“链不全、名不对、版本不配、续期没生效”。证书链必须按“叶子证书 → 中间证书 → 根证书(可省略)”顺序下发,Nginx 的 ssl_certificate 应指向 fullchain.pem,而不是单张域名证书。三项服务合一应理解为:证书签发、安装配置、长期续期监控一体化。

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

若输出中 Verify return code 不是 0 (ok),或小程序报 request:fail ssl handshake failed,优先查中间证书、SAN、SNI、TLS 版本和服务器时间。CDN/负载均衡回源也要同步更新证书,否则会出现“浏览器正常、APP 报错”的分裂现象。

根因清单:1)只上传域名证书,缺中间证书;2)证书 SAN 只写 example.com,未写 www/api;3)多域名虚拟主机未开 SNI 或默认站点证书错;4)TLS 1.0/1.1 未关闭或套件过旧;5)证书过期、服务器时间偏差;6)CDN 边缘节点已更新、回源节点仍旧证书;7)小程序请求域名未备案或不在合法域名列表。逐项用命令验证,比反复重装证书有效。

二、证书选型与 2026 有效期新规:DV、OV、EV、通配符怎么选

公共 TLS 证书有效期已进入缩短周期:此前单张证书最长 398 天;按 CA/Browser Forum SC-081,自 2026-03-15 起最长 200 天,2027-03-15 起 100 天,2028-03-15 起 47 天。Let’s Encrypt 仍为 90 天。因此“买一张管多年”的旧思路不可行,必须把自动续期纳入架构。小程序/APP API 优先 DV 单域名或通配符证书,配合 acme.sh/certbot 自动续期;企业对外门户可选 OV;EV 在主流浏览器已不单独显示绿色组织名,不必为 UI 买 EV。

openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -dates -subject -issuer -ext subjectAltName

选型看三个维度:域名数量(单域名、多域名 SAN、通配符)、验证方式(DV/OV/EV)、部署位置(Nginx、Apache、Tomcat、云 LB、CDN)。通配符 *.example.com 只覆盖一级子域,不覆盖 a.api.example.com;需要多级子域时用 *.api.example.com 或 SAN 多域名。证书私钥必须 2048 位 RSA 或 P-256 ECDSA,禁用 SHA-1 和 1024 位 RSA。

三、完整实操:生成 CSR、域名验证、签发与合并证书链

先准备私钥和带 SAN 的 CSR。不要用交互式输入,避免 CN 与 SAN 不一致:

mkdir -p /etc/nginx/ssl
cd /etc/nginx/ssl
openssl genrsa -out example.com.key 2048
cat > san.cnf <<'EOF'
[req]
distinguished_name=req_distinguished_name
req_extensions=req_ext
prompt=no
[req_distinguished_name]
C=CN
ST=Shanghai
L=Shanghai
O=Example Technology Ltd
CN=example.com
[req_ext]
subjectAltName=@alt_names
[alt_names]
DNS.1=example.com
DNS.2=www.example.com
DNS.3=api.example.com
EOF
openssl req -new -sha256 -key example.com.key -out example.com.csr -config san.cnf
openssl req -in example.com.csr -noout -text | grep -E 'Subject:|DNS:'

用 acme.sh 走 webroot 验证并安装:

curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com -d api.example.com --webroot /var/www/html
~/.acme.sh/acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/fullchain.pem --reloadcmd 'nginx -s reload'

商业证书到手后,合并链文件:cat example.com.crt intermediate.crt > fullchain.pem,顺序必须是叶子在前、中间在后。验证:openssl verify -untrusted intermediate.crt example.com.crt。Certbot 等价命令:certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --email ops@example.com --agree-tos --no-eff-email。

四、配置示例:Nginx、Apache、Tomcat/Spring Boot 三套可直接落地

Nginx 必须指向 fullchain.pem,并只启用 TLS 1.2/1.3。新版 Nginx 用 http2 on;,不要继续写 listen 443 ssl http2;:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    http2 on;
    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;
    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;
    }
}

Apache 2.4.8+ 使用 fullchain.pem 即可,SSLCertificateChainFile 已不需要:SSLEngine on、SSLCertificateFile /etc/httpd/ssl/fullchain.pem、SSLCertificateKeyFile /etc/httpd/ssl/example.com.key、SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1。Spring Boot/Tomcat 先转 PKCS12:openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -certfile chain.pem -name tomcat -out keystore.p12 -passout pass:changeit,再配置 server.ssl.key-store=file:/etc/tomcat/keystore.p12、server.ssl.key-store-password=changeit、server.ssl.key-store-type=PKCS12、server.ssl.key-alias=tomcat。

五、自动化续期与长期运维:acme.sh/certbot + 钩子 + 到期监控

200 天证书和 90 天 Let’s Encrypt 证书都不能靠手工续。acme.sh 安装后自带 cron,确认任务存在:crontab -l | grep acme.sh。手动演练:~/.acme.sh/acme.sh --cron --home ~/.acme.sh。certbot 用 certbot renew --dry-run 验证续期链路,用 deploy-hook 重载服务:certbot renew --deploy-hook 'systemctl reload nginx'。续期后必须检查实际线上证书,而不是只看文件时间:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem

-checkend 2592000 表示剩余不足 30 天返回非 0,可接入 Zabbix/Prometheus/云监控告警。多节点要同步分发证书:Nginx 用 nginx -t && nginx -s reload,Kubernetes 更新 Secret 后滚动重启,CDN 要分别更新边缘证书和回源证书。证书私钥权限设为 chmod 600,属主为运行用户;不要把 .key 提交到 Git。

六、对比表格:DV/OV/EV、免费与商业、通配符与多域名

选证书不要只看价格。APP/小程序 API 的核心诉求是“受信任、可自动续、SAN 正确、链完整”;企业门户才需要考虑组织验证和合规材料。下表按 2026 年有效期规则对比:

类型 验证方式 签发时长 最长有效期 浏览器显示 适用场景
DV 单域名 域名控制权 分钟级 200 天 锁标识 小程序/APP API、测试环境
DV 通配符 DNS/文件验证 分钟级 200 天 锁标识 多子域、SaaS 租户域名
OV 组织资料核验 1-3 天 200 天 锁标识 企业官网、对外业务系统
EV 组织+法律核验 3-7 天 200 天 主流浏览器不再单独显示绿色组织名 金融、政企合规场景
Let’s Encrypt ACME 自动验证 分钟级 90 天 锁标识 自动化优先、成本敏感业务

通配符只覆盖一级子域;多域名证书用 SAN 把 example.com、www.example.com、api.example.com 放在同一张证书里,减少部署数量。若使用云负载均衡/CDN,优先选支持自动续期和证书托管的方案,避免“证书文件换了、边缘节点没换”。

七、常见错误排查:真实报错与定位命令

报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate。根因是缺中间证书。处理:cat example.com.crt intermediate.crt > fullchain.pem,Nginx 改指 fullchain.pem,并用 openssl verify -untrusted intermediate.crt example.com.crt 验证。

报错 2:Verify return code: 20 (unable to get local issuer certificate)。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 看服务端下发了几个证书;只有一个叶子证书就是链不全。

报错 3:curl: (60) SSL: no alternative certificate subject name matches target host name 'www.example.com'。SAN 缺域名,重新签发时加 -d www.example.com,不要只改 CN。

报错 4:nginx: [emerg] cannot load certificate ... BIO_new_file() failed。查路径、权限和 SELinux:ls -l /etc/nginx/ssl、namei -l /etc/nginx/ssl/fullchain.pem,临时 setenforce 0 验证是否为 SELinux 上下文问题。

报错 5:小程序 request:fail ssl handshake failed。依次查 TLS 1.2+、证书链、SNI、域名备案与合法域名列表;用 openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 验证。

报错 6:Java 报 PKIX path building failed: unable to find valid certification path to requested target。服务端补全链,或把中间证书导入 JDK truststore:keytool -importcert -alias intermediate -file intermediate.crt -keystore cacerts。

报错 7:sslv3 alert handshake failure。多为 TLS 版本/套件不匹配,用 nmap --script ssl-enum-ciphers -p 443 example.com 对比客户端支持范围。

八、效果验证:从命令行到小程序真机的验收清单

部署后按“链、名、期、协议、跳转、HSTS”六项验收。先看证书链和 SAN:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
curl -I https://example.com
curl -I http://example.com
curl -sI https://example.com | grep -i strict-transport-security
nmap --script ssl-enum-ciphers -p 443 example.com

预期结果:Verify return code: 0 (ok);SAN 包含所有业务域名;notAfter 与续期计划一致;HTTP 返回 301 到 HTTPS;响应头有 Strict-Transport-Security;TLS 1.0/1.1 被拒绝,TLS 1.2/1.3 可握手。再验证旧协议:openssl s_client -connect example.com:443 -tls1 应失败。小程序端关闭“不校验合法域名”,用真机调试 wx.request,检查开发者工具 Network 的 TLS 版本和证书信息;APP 端用 Charles/Fiddler 或 openssl s_client 对比系统信任库结果。最后检查页面混合内容,浏览器 Console 不应出现 Mixed Content 警告。

常见问题

证书最长有效期到底是 398 天还是 200 天?

398 天是 2020 年至 2026 年 3 月前的上限。按 SC-081,自 2026-03-15 起公共 TLS 证书最长 200 天,2027-03-15 起 100 天,2028-03-15 起 47 天。Let’s Encrypt 仍为 90 天。

Let’s Encrypt 只有 90 天,能不能买一张“长期证书”?

不能。所有公共 CA 都受 CA/Browser Forum 有效期上限约束,所谓“长期”应理解为自动续期服务,而不是单张证书多年有效。用 acme.sh/certbot + 监控才是长期方案。

APP 和小程序一定要用 OV/EV 吗?

不必须。微信小程序和 Android/iOS 主要校验证书链、域名、有效期和 TLS 版本,DV 证书即可。OV/EV 用于企业合规、招投标或对外展示,EV 在主流浏览器已不单独显示绿色组织名。

只配置了证书文件,为什么安卓 APP 仍报证书错误?

常见原因是缺中间证书、SAN 不含请求域名、TLS 版本过低、CDN 回源证书未更新,或 Android 7+ 不信任用户手动安装的 CA。用 openssl s_client -showcerts 看服务端链,用 -tls1_2 验证协议。

通配符证书能覆盖三级子域名吗?

*.example.com 只覆盖 api.example.com 这类一级子域,不覆盖 a.api.example.com。需要 *.api.example.com 或把具体域名加入 SAN。

证书更新后小程序仍提示过期怎么办?

检查 CDN/负载均衡/容器是否仍挂旧证书,Nginx 是否 reload,DNS 多 IP 是否灰度不一致,客户端时间是否正确。用 openssl s_client 分别连每个 IP 验证 notAfter。

内容审核

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