跳到主要内容
ssl证书按装

微信小程序与网站 HTTPS 实战:SSL 证书申请、安装、配置与排错指南

微信小程序与网站 HTTPS 实战:SSL 证书申请、安装、配置与排错指南 — 微信小程序与网站 HTTPS 实战:SSL 证书申请、安装、配置与排错指南

问题背景与根因:小程序与浏览器为什么强制 HTTPS

微信小程序、Apple ATS、现代浏览器和支付回调都把 HTTPS 作为最低要求。小程序请求域名必须使用 HTTPS,通常要求 TLS 1.2 及以上,证书由公共信任 CA 签发,且证书链完整;使用自签名证书、链缺失或域名不匹配时,真机常见报错为 request:fail ssl hand shake error。浏览器侧则常见 NET::ERR_CERT_AUTHORITY_INVALID 或 curl: (60) SSL certificate problem: unable to get local issuer certificate。根因通常不是证书没装,而是证书链、SNI、443 安全组、TLS 版本或域名解析不一致。

证书有效期规则也已变化:公共信任 CA 签发的 TLS 证书单张最长有效期按 CA/B Forum 规则为 398 天,Let’s Encrypt 为 90 天,不存在可长期使用的公共信任永久证书。所谓证书代购或长期 CA 证书,必须确认是否公共信任、是否提供 fullchain、是否支持自动续期。EV 证书也不再在主流浏览器地址栏显示公司名称,购买时应以合规和业务要求为准,而不是视觉标识。

排查顺序建议:先用 dig +short example.com 确认解析,再用 ss -lntp | grep 443 确认监听,随后用 curl -vI https://example.com 看握手,最后用 openssl s_client -connect example.com:443 -servername example.com -showcerts 检查证书链。云服务器还要在安全组放行 443/TCP,Linux 防火墙执行 sudo ufw allow 443/tcp 或 sudo firewall-cmd --add-service=https --permanent && sudo firewall-cmd --reload。这些基础项不通过,后续改配置没有意义。

证书类型与选型:DV、OV、EV 与单域名、多域名、通配符

按验证强度分,DV 只验证域名控制权,几分钟到数小时可签发,适合个人站、API、微信小程序后端和下载站;OV 需要企业资料审核,通常 1-3 个工作日,适合企业门户;EV 审核更严,但 Chrome 77 起已取消地址栏公司名展示,Safari 等也弱化 EV 标识,因此 EV 的主要价值是组织审核和合规,不是更高加密强度。三类证书在 TLS 加密算法上没有本质差别,差别在身份审核、保险和品牌展示。

按覆盖范围分:单域名证书只保护一个 FQDN,例如 api.example.com;多域名证书通过 SAN 保护多个域名,例如 example.com、www.example.com、api.example.com;通配符证书保护 *.example.com 一层子域,但不保护 example.com 本身,也不保护 a.b.example.com。小程序后端如果同时有主域和 www,建议申请包含两个 SAN 的证书,或使用通配符加主域的组合。

选型时还要看续期方式:Let’s Encrypt 免费证书 90 天有效,必须用 certbot 或 ACME 客户端自动续期;商业 DV 常见 398 天,但到期前也要续期。证书代购或采购时要确认:CA 是否被主流信任库信任、是否给 fullchain、私钥是否由自己生成、是否支持 DNS API、是否含发票和续期提醒。不要购买所谓永久公共证书。命令上可用 openssl x509 -in fullchain.pem -noout -subject -issuer -dates 核对域名、颁发者和到期时间。

申请前准备与 CSR 生成:域名、TXT 验证、443 端口

准备项包括:域名已完成实名和备案(大陆服务器)、A/AAAA 记录指向目标服务器、443/TCP 在云安全组和系统防火墙放行、Web 服务已监听 80/443。DV 证书常用 DNS TXT 验证,提交后按 CA 提示添加记录,用 dig TXT _acme-challenge.example.com +short 或 nslookup -type=TXT _acme-challenge.example.com 检查生效。TXT 未生效时不要反复重签,先等 TTL 或检查是否漏了主机记录前缀。

如果 CA 要求上传 CSR,可在服务器本地生成私钥和 CSR,私钥不要发给任何人。单域名命令:openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com'。多域名或需要 SAN 时写配置文件:cat > san.cnf <<'EOF',内容包含 [req]、distinguished_name=req_distinguished_name、req_extensions=req_ext、prompt=no、[req_distinguished_name]、CN=example.com、[req_ext]、subjectAltName=@alt_names、[alt_names]、DNS.1=example.com、DNS.2=www.example.com,再执行 openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -config san.cnf。用 openssl req -in example.com.csr -noout -text 检查 SAN 是否完整。

私钥权限设为 chmod 600 example.com.key,属主为 root 或运行 Web 服务的账号。签发后应拿到服务器证书和中间 CA,Nginx 的 ssl_certificate 应使用服务器证书加中间 CA 的 fullchain,顺序不能反,根 CA 不要放入。可用 openssl verify -CAfile chain.pem fullchain.pem 做基础校验。若使用 certbot,可直接 sudo certbot --nginx -d example.com -d www.example.com,再用 sudo certbot renew --dry-run 验证自动续期。

完整实操步骤:Nginx 安装证书、301 跳转与安全组

以下步骤以 Ubuntu/Debian 的 Nginx 为例,证书文件放在 /etc/nginx/ssl/。第一步创建目录并放入文件:sudo mkdir -p /etc/nginx/ssl,将 fullchain.pem 和 privkey.pem 上传后执行 sudo chmod 600 /etc/nginx/ssl/privkey.pem。第二步编辑站点配置,先写 80 跳 443,再写 443 服务块。第三步执行 sudo nginx -t,输出 syntax is ok 和 test is successful 后再 sudo systemctl reload nginx。不要直接 restart 生产环境,reload 更平滑。

关键参数:ssl_certificate 指向 fullchain,ssl_certificate_key 指向私钥;ssl_protocols TLSv1.2 TLSv1.3; 禁用 TLS 1.0/1.1;ssl_session_cache shared:SSL:10m; 提升复用;HSTS 用 add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;,首次上线建议先用较短 max-age 验证。云安全组放行 443/TCP,系统防火墙执行 sudo ufw allow 443/tcp 或 firewalld 命令。若使用 CDN,回源也要支持 HTTPS,且 CDN 证书与源站证书分别配置。

301 跳转配置:server { listen 80; server_name example.com www.example.com; return 301 https://$host$request_uri; }。如果业务有多个域名,不要把所有域名都跳到主域,除非确认无 SEO 和回调影响。验证命令:curl -I http://example.com 应返回 301 和 Location: https://example.com/;curl -I https://example.com 应返回 200 或业务状态码。若返回 502,证书通常已通,问题在反向代理后端。

配置示例:Nginx、Apache、IIS/Tomcat 关键片段

Nginx 示例: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/privkey.pem; 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'; 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 / { root /var/www/html; index index.html; } }。Nginx 1.25.1 之前若 http2 on 报错,改为 listen 443 ssl http2;。

Apache 2.4.8+ 示例:<VirtualHost *:443> ServerName example.com SSLEngine on SSLCertificateFile /etc/httpd/ssl/fullchain.pem SSLCertificateKeyFile /etc/httpd/ssl/privkey.pem SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 Header always set Strict-Transport-Security 'max-age=31536000; includeSubDomains' </VirtualHost>。旧版 Apache 若需要单独中间链,使用 SSLCertificateChainFile /etc/httpd/ssl/chain.pem。修改后执行 sudo apachectl configtest 和 sudo systemctl reload httpd 或 apache2。

IIS 导入 PFX 后在站点绑定 443,勾选 SNI,证书链由中间 CA 自动拼接;Tomcat 8.5+ 可在 server.xml 的 Connector 中配置 SSLCertificateFile、SSLCertificateKeyFile、SSLCertificateChainFile,或使用 JKS/PKCS12 keystore。Tomcat 要确认 SSLEnabled=true、scheme=https、secure=true。所有平台都要确保私钥与证书匹配,可用 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 和 openssl rsa -in privkey.pem -noout -modulus | openssl md5 比较输出。

对比表格:证书类型、有效期与适用场景

下表把常见证书类型和覆盖方式放在一起,便于按业务选型。注意公共信任证书没有永久有效,DV/OV/EV 的加密强度相同,区别在审核和保障;通配符不覆盖主域本身,多域名要核对 SAN 列表。Let’s Encrypt 90 天,商业公共 CA 当前单张最长 398 天,续期应自动化。

类型 验证内容 典型签发 有效期 适用场景 注意
DV 单域名 域名控制权 分钟到小时 Let’s Encrypt 90 天;商业 CA 最长 398 天 个人站、API、小程序后端 需完整链
DV 多域名 SAN 多个域名控制权 分钟到小时 同上 主域+www+api 核对 SAN 数量
DV 通配符 DNS 验证 分钟到小时 同上 大量一级子域 不保护主域和二级子域
OV 组织+域名 1-3 工作日 商业 CA 最长 398 天 企业门户 需营业执照
EV 扩展组织审核 1-5 工作日 商业 CA 最长 398 天 金融、电商合规 主流浏览器不再显示公司名

采购或代购时要求供应商提供:fullchain 文件、中间 CA、到期时间、颁发者、证书透明日志链接、续期方式。若供应商只给单证书不给链,浏览器可能报 NET::ERR_CERT_AUTHORITY_INVALID。用 openssl s_client -connect example.com:443 -servername example.com -showcerts 可看到链是否完整。表格中的 398 天是当前公共信任 TLS 证书单张上限,CA 若调整规则以公告为准。

常见错误排查:真实报错与处理命令

报错一:nginx: [emerg] SSL_CTX_use_PrivateKey failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。原因是证书与私钥不匹配,常见于上传错文件、复制了旧私钥或 fullchain 顺序错。处理:分别计算模数,openssl x509 -in fullchain.pem -noout -modulus | openssl md5 与 openssl rsa -in privkey.pem -noout -modulus | openssl md5,输出必须一致;不一致就重新配对。

报错二:curl: (60) SSL certificate problem: unable to get local issuer certificate 或浏览器 NET::ERR_CERT_AUTHORITY_INVALID。原因是缺中间 CA 或链顺序错误。Nginx 的 ssl_certificate 必须用 fullchain,服务器证书在前、中间 CA 在后,根 CA 不放。Apache 旧版用 SSLCertificateChainFile。验证:openssl s_client -connect example.com:443 -servername example.com -showcerts,看输出是否包含中间 CA,最后用 openssl verify -CAfile chain.pem fullchain.pem。

报错三:小程序 request:fail ssl hand shake error。优先查 TLS 版本、证书链、域名和 443 端口。用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 和 -tls1_3 分别测试;确认没有使用自签名证书、没有 IP 直连、域名已在小程序后台配置为 request 合法域名。报错四:SSL_ERROR_NO_CYPHER_OVERLAP 表示协议或套件不匹配,检查是否只开 TLS 1.3 而客户端只支持 TLS 1.2,或 ssl_ciphers 过窄。报错五:AH01909: RSA certificate configured for example.com:443 does not include an ID which matches the server name,检查 ServerName 与证书 SAN 是否一致,以及是否启用了 SNI。

效果验证:openssl、curl、testssl.sh 与小程序真机

服务端验证先看证书:openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -subject -issuer -dates,确认 CN/SAN、颁发者和 notAfter。再看握手:openssl s_client -connect example.com:443 -servername example.com -showcerts,输出中应看到 Verify return code: 0 (ok),证书链包含服务器证书和中间 CA。分别测协议:openssl s_client -connect example.com:443 -servername example.com -tls1_2 应成功,-tls1_1 应失败或按策略拒绝。

HTTP 层验证:curl -I http://example.com 看 301 和 Location;curl -I https://example.com 看 200 和 HSTS 头;curl -vI https://example.com 看 TLS 版本和证书主题。批量检查可用 testssl.sh https://example.com,重点看证书链、TLS 1.0/1.1 是否关闭、HSTS、OCSP stapling。若使用 CDN,要在 CDN 控制台也验证证书部署和回源协议,避免源站已修但边缘仍报错。

小程序侧:在微信开发者工具打开不校验合法域名只能用于开发,真机必须关闭;在微信公众平台配置 request 合法域名,域名必须 HTTPS、备案、不能带端口(默认 443)、不能是 IP。真机测试时观察 wx.request 的 fail 回调,若仍报 ssl hand shake error,用手机浏览器访问同一 URL,再用 openssl s_client 对比证书链。Apple ATS 还要求 TLS 1.2 及以上,iOS 上要确认没有启用过时的 TLS 1.0。

常见问题

公共信任证书最长能用 398 天吗?

当前公共信任 CA 签发的 TLS 证书单张最长有效期按 CA/B Forum 规则为 398 天;Let’s Encrypt 为 90 天。所谓永久公共证书不存在,采购时不要相信长期 CA 证书宣传,应配置自动续期和到期告警。

微信小程序必须用 OV 或 EV 证书吗?

不必须。小程序主要校验证书是否公共信任、域名是否匹配、证书链是否完整、TLS 版本是否满足要求。DV 证书即可满足大多数小程序后端场景,企业合规另有要求时再选 OV/EV。

EV 证书还能在浏览器显示公司名吗?

不能按旧资料理解。Chrome 77 起已取消 EV 证书地址栏公司名展示,Safari 等也弱化该标识。EV 的价值在组织审核和合规,不代表加密强度高于 DV/OV。

Nginx 报 key values mismatch 怎么处理?

证书和私钥不匹配。用 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 与 openssl rsa -in privkey.pem -noout -modulus | openssl md5 比较,输出不一致就重新上传正确配对文件,并确认 fullchain 顺序为服务器证书在前、中间 CA 在后。

已经放行 443 为什么还打不开?

依次检查云安全组、系统防火墙、Nginx/Apache 是否监听 443、证书路径是否存在、SELinux 是否阻止读取。命令:ss -lntp | grep 443、sudo nginx -t、tail -n 50 /var/log/nginx/error.log。若使用 CDN,还要检查 CDN 回源和边缘证书。

证书代购要注意什么?

确认 CA 是否被主流信任库信任、是否提供 fullchain、私钥是否自己生成、是否支持自动续期和到期提醒、是否含发票。不要购买所谓永久公共证书,也不要让供应商长期持有你的私钥。

内容审核

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