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

网站与微信小程序 HTTPS 证书配置全流程:CSR 生成、398 天证书链部署与自动续期

网站与微信小程序 HTTPS 证书配置全流程:CSR 生成、398 天证书链部署与自动续期 — 网站与微信小程序 HTTPS 证书配置全流程:CSR 生成、398 天证书链部署与自动续期

一、HTTPS 为什么成了硬门槛:问题背景与三类根因

2024 年之后,HTTPS 已不是「加分项」而是硬门槛:Chrome 90+ 对 HTTP 页面在地址栏直接标注「不安全」;微信小程序 wx.request 只允许 HTTPS 请求,且要求 TLS 1.2 及以上、域名已完成 ICP 备案、不能使用 IP 或非 443 端口;iOS 的 ATS 默认拒绝非 TLS 1.2 或使用弱套件的连接。很多站点「电脑上能打开、手机上小程序报错」,根因通常集中在三类。

  • 证书链不完整:服务器只下发了叶子证书(leaf),没有附带中间证书(intermediate)。桌面 Chrome 会通过证书里的 AIA 地址自动补链,所以看起来正常;但 Android WebView、微信小程序、Java 的 HttpClient 不会补链,直接抛 PKIX path building failed 或 ssl handshake failed。
  • 有效期管理缺失:公有 CA 签发的单张证书有效期上限是 398 天,Let's Encrypt 是 90 天,「买一张长期证书用三年」的做法早已不成立。
  • 协议与套件过时:TLS 1.0/1.1 已被主流客户端废弃,SHA-1 签名证书被全面拒绝,只开 ssl_protocols TLSv1 的服务器在握手阶段就会失败。

先做一次体检,把问题定位清楚再动手:

# 查看服务端实际下发的证书链与有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

# 用系统根证书库验证链是否完整(Verify return code: 0 才算通过)
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt -verify_return_error </dev/null 2>&1 | grep -E "Verify return code|verify error"

# 看是否还开着 TLS 1.0/1.1(能握手成功说明需要整改)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null 2>&1 | grep -E "Protocol|handshake failure"

判读方法:Verify return code 不是 0,或 -showcerts 只输出一张证书,属于证书链问题;notAfter 距今不足 30 天,属于续期问题;-tls1_1 仍能握手,属于协议配置问题。三类问题对应后文的三种解法,不要混着改。

二、证书选型:DV/OV、单域名/泛域名与 398 天有效期新规

选证书看两个维度:验证等级(DV/OV/EV)和覆盖范围(单域名/多域名/泛域名)。微信小程序只要求「公有 CA 签发 + 链完整 + TLS 1.2+」,DV 证书完全够用,不必为 OV/EV 多付钱。

证书类型 验证方式 单张最长有效期 覆盖范围 小程序可用
DV 单域名 DNS-01 / HTTP-01 398 天(Let's Encrypt 90 天) example.com 可用
DV 泛域名 必须 DNS-01 398 天 / 90 天 *.example.com 一级子域 可用
OV 单域名/多域名 组织信息核验 398 天 多个 SAN 域名 可用
自签名证书 无 自定义 自定义 不可用

关于「长期 CA 证书」必须纠正一个过时认知:自 2020-09-01 起,公有 CA 签发的单张 TLS 证书有效期上限为 398 天;CA/B Forum 已通过分阶段缩短方案,2026-03-15 起降到 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。所谓「长期」只能通过自动续期实现,不能靠买一张长有效期证书。另外,泛域名证书不覆盖 example.com 主域本身,也不覆盖 a.b.example.com 二级子域,签证书时要同时带上主域 SAN。

方案 市场参考价 说明
Let's Encrypt DV 0 元 90 天,必须自动化续期
商业 DV 单域名 免费至数百元/年 398 天,售后有保障
商业 DV 泛域名 数百至两千元/年 子域多时性价比最高
单纯证书安装配置服务 约 100 元 已有证书,只做部署与 301 跳转
单域名证书 + 配置服务 约 200 元 代购 + 部署 + 链修复
泛域名证书 + 配置服务 约 600 元 含 DNS-01 验证与自动续期

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

CSR 由服务器本地生成,私钥绝不出服务器。注意三点:CN 只填主域名,其余域名全部写进 SAN(Chrome 58+ 只认 SAN);-nodes 表示不加口令,否则 Nginx 启动要交互输密码,或需额外配置 ssl_password_file;私钥权限必须是 600。

install -d -m 700 /etc/nginx/ssl && cd /etc/nginx/ssl

# RSA 2048,兼容性最好
openssl req -new -newkey rsa:2048 -sha256 -nodes -keyout example.com.key -out example.com.csr -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"

# 或 ECDSA P-256,握手更快、包更小
openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -sha256 -nodes -keyout example.com.ec.key -out example.com.ec.csr -subj "/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:*.example.com"

chmod 600 example.com.key
openssl req -in example.com.csr -noout -verify
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

常见坑:OpenSSL 1.1.1 以下版本不支持 -addext,需要在自建 config 里写 [req] req_extensions = v3_req 与 [v3_req] subjectAltName = DNS:example.com,DNS:www.example.com,再用 -config 指定。CSR 提交给 CA 后不可再改域名,若发现漏了 www,只能重新生成 CSR 重签。把 openssl req -noout -text 的输出连同 CSR 一起存档,出问题时便于核对指纹。

四、签发后的证书链合并与 Nginx/Apache 配置示例

CA 返回的压缩包里通常有三个文件:服务器证书(leaf)、中间证书(intermediate)、根证书(root,不要部署)。部署时把 leaf 与 intermediate 按顺序拼接成 fullchain.pem,顺序颠倒会导致握手失败;中间证书单独存为 chain.pem,供 OCSP Stapling 使用。

cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted intermediate.crt example.com.crt
# 输出 example.com.crt: OK 表示链完整
# /etc/nginx/conf.d/example.com.conf
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;  # 权限 600,不带口令

    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;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
    resolver 223.5.5.5 119.29.29.29 valid=300s;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    root /var/www/html;
    index index.html;
}
<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile    /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
    # httpd 2.4.8+ 已将链证书合并进 SSLCertificateFile,无需再写 SSLCertificateChainFile
    SSLProtocol -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite HIGH:!aNULL:!MD5:!3DES:!RC4
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

改完先 nginx -t 或 apachectl configtest,通过后 systemctl reload nginx。HSTS 只在确认全站 HTTPS 无混合内容后再开 includeSubDomains,否则会把未上证书的子域一起锁死。云负载均衡(SLB/CLB/CDN)场景要把 fullchain 完整贴进证书框,私钥单独一栏,且回源协议与 443 监听都要检查。

五、自动化续期:certbot 与 acme.sh 的 DNS-01 方案

既然 398 天已是上限并将继续缩短,续期必须自动化。HTTP-01 适合单域名,泛域名只能走 DNS-01。

# 方式一:certbot + webroot(单域名/多域名)
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --deploy-hook "systemctl reload nginx"
certbot renew --dry-run
systemctl list-timers | grep certbot

# 方式二:acme.sh + DNS API(泛域名,无需 80 端口)
curl https://get.acme.sh | sh -s email=ops@example.com
export Ali_Key="LTAI5t****" Ali_Secret="****"
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d "*.example.com" --keylength ec-256
~/.acme.sh/acme.sh --install-cert -d example.com --ecc --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/fullchain.pem --reloadcmd "systemctl reload nginx"

要点:--install-cert 会把证书复制到指定路径并注册续期钩子,不要直接引用 ~/.acme.sh/ 下的文件;--keylength ec-256 生成 ECDSA 证书,比 RSA 握手少一个 RTT。多节点或容器环境要保证每台机器都能拿到新证书,最稳妥的做法是把续期后的 fullchain 推到对象存储,各节点用 sidecar 定时拉取并 reload。续期后务必确认进程真的 reload 了:ps -eo lstart,cmd | grep nginx 看 master 进程启动时间是否更新。

六、微信小程序 HTTPS 配置要点与校验清单

小程序侧的失败大多是配置问题而不是代码问题,按下面清单逐项核对:

  • 域名已完成 ICP 备案,且是「已备案的二级及以上域名」,不能用 IP、不能用 localhost。
  • 只能使用 443 端口,wx.request 的 URL 里不能出现 :8443 之类的端口号。
  • 证书由公有 CA 签发,TLS 1.2 及以上;自签名、私有 CA、过期证书一律握手失败。
  • 证书链必须完整(Android 端不补链),fullchain.pem 里必须有中间证书。
  • 在「微信公众平台 → 开发 → 开发管理 → 服务器域名」里把域名加入 request 合法域名,每月修改次数有限(约 50 次),改完需重新编译。
  • 小程序内嵌 H5 还要在「业务域名」里配置并上传校验文件到站点根目录。
  • 开发者工具「详情 → 本地设置 → 不校验合法域名」只影响工具,真机预览一定按正式规则校验。
// 真机联调时打印失败原因,便于区分是域名配置还是握手问题
wx.request({
  url: "https://api.example.com/v1/ping",
  method: "GET",
  success: res => console.log("ok", res.statusCode),
  fail: err => console.error("fail", err.errMsg, err.errno)
});

典型报错对应关系:request:fail ssl handshake failed 多为 TLS 版本过低或证书链不全;errCode: 600001 表示 URL 非法(含端口、IP 或协议不是 https);该请求域名不在以下 request 合法域名列表中 表示后台未配置或配置后未重新编译。排查顺序建议:先在手机浏览器打开同一 URL,若能打开而小程序报错,八成是后台域名白名单问题。

七、常见错误排查:真实报错与修复动作

报错原文 根因 修复动作
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺中间证书 cat cert.crt chain.crt > fullchain.pem 后 reload
NET::ERR_CERT_COMMON_NAME_INVALID 访问的域名不在 SAN 中 重签证书补齐 SAN,或改用匹配域名访问
NET::ERR_CERT_DATE_INVALID 证书过期或客户端时间错误 续期;核对服务器 NTP 时间
nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 证书与私钥不匹配 用 modulus 比对后换回正确私钥
nginx: [warn] "ssl_stapling" ignored, issuer certificate not found ssl_trusted_certificate 未配或文件缺中间证书 指向 chain.pem 并 reload
curl: (35) error:1408F10B:SSL routines:ssl3_get_record:wrong version number 443 端口跑的是明文 HTTP 检查 listen 与反代端口映射
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException Java 客户端不补链 服务端下发完整 fullchain,或在 truststore 导入中间证书

私钥与证书是否匹配,用两条命令比对 MD5 即可:

openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

两个值一致才说明配对。若使用 ECDSA 证书,第二条命令改为 openssl ec -noout -modulus -in example.com.key。另有一个隐蔽坑:同一台机器上 server_name 重复导致 Nginx 取第一个 server 块的证书,表现为「某些域名证书串了」,用 nginx -T | grep -n "server_name" 全局检查一遍。

八、效果验证与到期监控

部署完成不等于生效,必须从客户端视角验证四件事:证书链完整、域名匹配、协议达标、跳转正确。

# 1. 本地证书信息与 SAN
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -subject -issuer -dates -ext subjectAltName

# 2. 域名匹配校验(返回 does match 才对)
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -checkhost www.example.com

# 3. 剩余有效期是否大于 30 天(返回 1 表示不足)
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -checkend 2592000; echo $?

# 4. 在线握手结果:协议、套件、链验证结果
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>&1 | grep -E "Protocol|Cipher|Verify return code"

# 5. 301 跳转是否生效
curl -sSI http://example.com | head -3
curl -sS -o /dev/null -w "%{http_code} %{ssl_verify_result}n" https://www.example.com

浏览器侧可再用 SSL Labs 打分(目标 A 及以上),小程序侧用真机预览跑一次核心接口。监控用 cron 做兜底,提前 7 天告警:

0 3 * * * /usr/bin/openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -checkend 604800 || echo "$(date) SSL 证书 7 天内到期" | mail -s "SSL 到期告警" ops@example.com

如果续期脚本已跑过但浏览器仍显示旧证书,先确认 CDN/负载均衡上的证书是否同步更新,再确认 Nginx 是否 reload,最后清客户端会话缓存。多节点架构建议把「证书指纹 + 到期时间」纳入统一监控,而不是只看单台机器。

常见问题

现在还能买到「长期有效」的 SSL 证书吗?

不能。公有 CA 签发的单张 TLS 证书有效期上限为 398 天(2020-09-01 起生效),Let's Encrypt 为 90 天,且 CA/B Forum 已通过分阶段缩短方案:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。所谓「长期」只能通过 certbot、acme.sh 等工具自动续期来实现,购买多年期产品时实际签发的仍是 398 天以内的单张证书,到期需重新签发。

泛域名证书能覆盖 example.com 主域和 a.b.example.com 吗?

都不覆盖。*.example.com 只匹配一级子域(如 www、api、m),不匹配主域 example.com,也不匹配两级子域 a.b.example.com。签发时应同时提交 example.com 与 *.example.com 两个 SAN,主域和子域才能一起用。

小程序提示 request:fail ssl handshake failed 怎么排查?

先判断是协议还是证书链问题:在手机浏览器打开同一 URL,若浏览器正常而小程序失败,多半是后台「request 合法域名」未配置或改后未重新编译;若浏览器也异常,用 openssl s_client -connect 域名:443 -servername 域名 检查是否只下发了叶子证书、是否仍支持 TLS 1.0/1.1。修复方式是把中间证书拼进 fullchain.pem,并在 Nginx 中只保留 TLSv1.2 TLSv1.3。

为什么电脑浏览器显示安全,安卓和微信小程序却报证书错误?

因为桌面 Chrome 会读取证书里的 AIA 扩展自动下载中间证书补链,而 Android WebView、微信小程序、Java HttpClient 不做这个动作。判断方法是看服务端是否只返回了一张证书,openssl verify -untrusted intermediate.crt cert.crt 返回 OK 才说明链完整。

100 元的「证书配置服务」和自建 Let's Encrypt 有什么区别?

差异在责任边界而非技术:代配置服务通常包含证书链修复、301 跳转、HSTS、OCSP Stapling 与首次部署验证,适合没有运维人力或证书即将过期需要紧急上线的场景;Let's Encrypt 零成本但要求自己维护 ACME 客户端、DNS API 凭据与续期钩子,一旦续期失败就是线上事故。无论选哪种,都要把到期监控和续期演练做进流程。

内容审核

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