中小企业 HTTPS 证书申请、部署与排错实战:兼容微信小程序与 iOS(Nginx/Apache/Tomcat/IIS)
一、问题背景与根因:小程序和 iOS 为什么强制 HTTPS
微信小程序的 wx.request、wx.uploadFile、wx.connectSocket 只接受 https:// 与 wss://,且请求域名必须在微信公众平台「开发管理 → 服务器域名」中配置为合法域名,域名需完成 ICP 备案。iOS 端 App Transport Security(ATS)自 iOS 9 起默认拒绝明文 HTTP,要求 TLS 1.2 及以上、证书使用 SHA-256 签名、密码套件支持前向保密(ECDHE)。因此“证书装上了但小程序还是打不开”是中小企业最常见的工单。
把这类故障归因,九成落在下面四类:
- 证书链不完整:服务器只发了域名证书(leaf certificate),没有发中间证书(intermediate CA)。桌面浏览器会通过 AIA 自动补链,所以“浏览器正常”;但微信小程序、iOS、Java、curl、Python requests 不做 AIA fetching,直接报链校验失败。
- 域名不匹配:证书 SAN 只签了
example.com,用户访问www.example.com触发ERR_CERT_COMMON_NAME_INVALID。 - 协议或套件过时:仍开启 TLS 1.0/1.1、只保留 RSA 密钥交换、使用 SHA-1 签名证书,会被 ATS 与小程序拒绝。
- 混合内容:页面本身 HTTPS,但内部
http://的图片、JS、接口被浏览器拦截,小程序则直接请求失败。
另外,明文 HTTP 会被运营商网关、公共 Wi-Fi 注入广告或篡改下载内容,这正是“防劫持”的技术本质:TLS 提供传输加密与完整性校验,中间设备在不解密的前提下无法篡改报文。HTTPS 不改变业务逻辑,但会改变运维细节——证书链、TLS 版本、跳转、续期,每一项都可能导致线上不可用。
快速定位根因的第一条命令:
openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null | grep -E "Verify return code|^ *[0-9]+ s:|i:"
输出 Verify return code: 0 (ok) 且能看到至少两张证书(域名证书 + 中间证书),说明链正常;若返回 21 (unable to verify the first certificate),基本就是缺中间证书。
二、证书选型与申请:DV/OV/EV、通配符、398 天有效期与 CSR 生成
选型先看用途:DV(Domain Validation)只校验域名控制权,通常分钟级签发,适合绝大多数中小企业官网、API 与小程序后端;OV(Organization Validation)额外校验企业主体资质,1–3 个工作日签发,适合有支付、招投标、等保合规要求的场景;EV(Extended Validation)校验最严,但自 Chrome 77(2019 年)起主流浏览器已不再展示绿色地址栏与企业名称,除非客户明确要求,不必为此多付费。通配符证书 *.example.com 只覆盖一级子域,不覆盖 example.com 裸域,也不覆盖 api.test.example.com 这类多级子域,裸域必须写进 SAN。
有效期规则必须更新认知:CA/Browser Forum 规定公有 CA 签发的 TLS 服务器证书单张最长 398 天(2020 年 9 月起执行,替代原来的 825 天);Let’s Encrypt 等免费 DV 证书固定 90 天。后续还会继续缩短:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天(以 CA/B Forum 最终生效文本为准)。所以“买多年期证书就不用管了”是错误理解——多年订单通常是每年重新签发一张,续期流程仍要建立。
在服务器上生成私钥与 CSR(以 RSA 2048 + SHA-256 为例,命令可直接执行):
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
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 Co.,Ltd/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"
chmod 600 example.com.key
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
注意 CN 只保留主域名,多域名全部写进 SAN;O 字段用英文注册名,避免编码问题导致 OV 审核退回。私钥一旦生成就不要重新生成,否则 CSR 与后续证书不匹配。
CA 签发后一般给你三个文件:域名证书 example.com.crt、中间证书 intermediate.crt(或 ca_bundle.crt)、根证书 root.crt。部署前先拼链并验证:
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt
输出 example.com.crt: OK 才算链完整。根证书不要拼进 fullchain.pem,部分客户端会因链过长或多出未知根而判定非法。
三、Nginx 完整配置示例:证书链、TLS 1.2/1.3、OCSP Stapling 与 301 跳转
以下配置适用于 Nginx 1.20+,把 example.com 换成你的域名即可直接使用。核心是三件事:ssl_certificate 指向拼好的全链文件、只开 TLS 1.2/1.3、80 端口 301 跳转 443。
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
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_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/fullchain.pem;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security "max-age=31536000" always;
add_header X-Content-Type-Options nosniff always;
root /var/www/example;
index index.html;
}
几个容易踩的细节:
ssl_certificate必须是 fullchain,而不是单张example.com.crt——这是小程序握手失败第一大原因。- 不要写
ssl_protocols TLSv1 TLSv1.1 TLSv1.2。TLS 1.0/1.1 已被 RFC 8996 正式弃用,且不满足 iOS ATS 要求。 - HSTS 不要一上来就
max-age=31536000。先用max-age=600观察一天,确认所有子域都能 HTTPS 再加大,否则回滚成本很高。 - 内网服务器无法访问 DNS 时,
ssl_stapling会拖慢握手,可临时关闭。 - 如果站点还有
http://静态资源,加add_header Content-Security-Policy "upgrade-insecure-requests" always;可自动升级,但小程序接口必须改代码,不能依赖响应头。
生效前先检查权限与语法(Nginx worker 用户必须能读到私钥):
namei -l /etc/nginx/ssl/example.com.key
nginx -t && nginx -s reload
四、Apache / Tomcat / IIS 配置示例(Windows 2003 已不可用)
原文提到“不限平台”,但实际每个平台配置方式差别很大,且旧系统已经不满足 ATS 要求。下面给可直接套用的最小配置。
Apache 2.4(httpd-ssl.conf):
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile "/etc/httpd/ssl/example.com.crt"
SSLCertificateKeyFile "/etc/httpd/ssl/example.com.key"
SSLCertificateChainFile "/etc/httpd/ssl/intermediate.crt"
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Apache 2.4.8 之后也可以把中间证书直接拼进 SSLCertificateFile,此时省略 SSLCertificateChainFile。校验:apachectl configtest。
Tomcat 9/10:先用 OpenSSL 把 PEM 转成 PKCS12,再在 server.xml 里引用:
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -name example -out example.p12 -passout pass:changeit
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="200" SSLEnabled="true" scheme="https" secure="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.p12"
certificateKeystorePassword="changeit"
certificateKeystoreType="PKCS12"
type="RSA" />
</SSLHostConfig>
</Connector>
IIS 10+:把 CA 给的 .pfx(含私钥)导入「本地计算机 → 个人 → 证书」,中间证书导入「中间证书颁发机构」;站点 → 绑定 → 添加 https/443,多站点时勾选「需要服务器名称指示(SNI)」。导入后执行 iisreset。
关于 Windows Server 2003 / IIS 6:该系统早已停止安全更新,默认不支持 TLS 1.2,无法可靠满足现代客户端要求,微信小程序与 iOS 会直接握手失败。正确做法是把站点迁移到 Windows Server 2016+ / IIS 10,或直接换成 Nginx。继续在 2003 上折腾证书没有工程价值。
所有平台共同点:证书文件必须是 PEM(Base64)或 PFX,私钥权限 600,且服务进程账户可读;配置改完先 configtest 再 reload,避免 reload 失败导致整站 502。
五、选型与费用对比:DV/OV/EV、通配符与人工部署服务
很多中小企业真正纠结的不是技术,而是“买哪种、要不要买服务”。下面两张表给出判断依据(价格为人工服务参考价,实际随 CA 促销与汇率波动)。
表 1:证书类型对比
| 类型 | 校验内容 | 典型签发时长 | 小程序/iOS 信任 | 适用场景 |
|---|---|---|---|---|
| 免费 DV(Let’s Encrypt / ZeroSSL) | 域名控制权(HTTP-01/DNS-01) | 分钟级 | 信任 | 个人站、测试环境、可自动化的生产站 |
| 付费 DV | 域名控制权 | 几分钟至数小时 | 信任 | 中小企业官网、小程序 API |
| OV | 域名 + 企业工商资质 | 1–3 个工作日 | 信任 | 电商支付、招投标、等保 |
| EV | 严格企业核验 | 3–7 个工作日 | 信任(无绿色地址栏) | 金融、大型企业品牌 |
通配符 *.example.com |
域名控制权 | 几分钟至 1 天 | 信任(仅一级子域) | 多子域、多环境统一管理 |
表 2:证书 + 部署服务参考价
| 服务项 | 包含内容 | 参考价(元/年) |
|---|---|---|
| 单域名证书 + 配置 + 全站跳转 | DV 证书、安装、80→443 301 | 300 |
| 单域名证书 + 配置 | DV 证书、安装 | 200 |
| 单域名证书(不含配置) | 仅签发证书文件 | 100 |
| 通配符证书 + 配置 | *.example.com、安装 |
900 |
| 纯安装配置(客户自备证书) | 替换证书、链校验、重载 | 100 |
| 全站 HTTP→HTTPS 跳转 | Nginx/Apache/IIS 跳转 + 混合内容排查 | 100 |
判断建议:单域名 + 能自己改配置 → 用免费 DV 配 acme.sh 自动续期,成本最低;子域多(api、m、static、admin)→ 通配符一次覆盖,省去逐个签发;需要给甲方看 OV 证书主体 → 买 OV;一年只改一次配置、没有专职运维 → 买“证书 + 配置 + 跳转”打包服务更省心。注意无论买哪种,398 天上限决定了你每年至少要做一次续期,务必确认服务商报价是否含续期。
六、常见错误排查:真实报错、原因与修复命令
下面这些报错来自实际工单,按“报错原文 → 原因 → 修复”给出。
-
curl: (60) SSL certificate problem: unable to get local issuer certificate
原因:服务端没发中间证书。修复:cat example.com.crt intermediate.crt > fullchain.pem,Nginx 把ssl_certificate指向 fullchain,重载后复查。 -
浏览器
NET::ERR_CERT_COMMON_NAME_INVALID/SSL_ERROR_BAD_CERT_DOMAIN
原因:SAN 不含当前域名(常见是只签了裸域,用户走 www)。核对:openssl x509 -in fullchain.pem -noout -text | grep -A1 "Subject Alternative Name";修复是重新签发并包含www。推荐 推荐服务 · 一站式办理 由云市场认证服务商承接,下单后按需沟通交付。腾讯云市场 NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装 各服务器环境 SSL 证书安装配置,教程看不懂?直接交给服务商办。 查看服务 → 阿里云市场 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名 DV 单域名 DV 证书代购,主流品牌可选,比官网渠道更省。 查看服务 → 阿里云市场 Wildcard 通配符 SSL 证书安装部署续费申请 一张通配符保护全部一级子域名,含安装部署与续费服务。 查看服务 → 腾讯云市场 SSL证书申请+配置 · 宝塔/WDCP 面板全站加密(OV 企业单域名等规格) 付费证书云上签发、一键部署到宝塔/WDCP 站点,OV 企业单域名可选。 查看服务 → 阿里云市场 企业级 EV / OV 证书与代码、驱动签名服务 SSL EV/OV 证书 + 软件代码签名、驱动签名,企业级一站式办理。 查看服务 → 阿里云市场 GlobalSign 代码签名证书服务(OV/EV 企业版) 对 exe/dll/驱动等软件做数字签名,消除「未知发布者」警告,企业版含申请代办。 查看服务 → 阿里云市场 HTTPS证书申请 · SSL证书安装部署 · 证书续费 证书过期、部署报错、需要续期?申请+部署+续费一站式办理。 查看服务 → -
nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
原因:证书和私钥不配套(换证书时忘了换 key)。比对:openssl x509 -noout -modulus -in fullchain.pem | openssl md5与openssl rsa -noout -modulus -in example.com.key | openssl md5,两者必须一致;ECDSA 证书改用openssl x509 -pubkey -noout -in fullchain.pem | openssl md5与openssl pkey -pubout -in example.com.key | openssl md5比对。 -
小程序报
request:fail ssl hand shake error
原因优先级:证书链不全 > 只支持 TLS 1.0/1.1 > 域名未备案或未加入「服务器域名」白名单。先用openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null确认握手可用,再在微信公众平台核对 request 合法域名。 -
Java 客户端
javax.net.ssl.SSLHandshakeException: PKIX path building failed ... unable to find valid certification path to requested target
原因:服务端缺中间证书,或对方 JDK 信任库没有该根。优先补链;确需导入时执行keytool -importcert -file intermediate.crt -alias example-ca -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit。 -
SSL_ERROR_RX_RECORD_TOO_LONG或curl: (35) ... wrong version number
原因:用 https 访问了 http 端口(或反向代理后端口写错)。检查listen 443 ssl与 upstream 端口。 -
curl: (60) SSL certificate problem: certificate has expired
原因:证书过期。查看到期时间:openssl x509 -in fullchain.pem -noout -dates;长期方案是acme.sh --install-cert ... --reloadcmd "nginx -s reload"或certbot renew --deploy-hook "systemctl reload nginx"。 -
iOS 报
NSURLErrorServerCertificateUntrusted
原因:自签名证书、缺中间证书、或服务器时间偏差导致 notBefore 未生效。执行date -u并校准 NTP。 -
Nginx 日志
cannot load certificate key ... Permission denied
原因:worker 用户读不到私钥。修复:chown root:root example.com.key && chmod 600 example.com.key;SELinux 开启时执行restorecon -Rv /etc/nginx/ssl或chcon -t httpd_config_t /etc/nginx/ssl/example.com.key。
七、效果验证:从 openssl 到 SSL Labs A+ 与小程序真机
配置改完不要只看浏览器绿锁,按下面顺序逐层验证。
1)证书链与有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "Verify return code|^ *[0-9]+ s:|i:"
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
期望:Verify return code: 0 (ok),-showcerts 至少输出两张证书(域名 + 中间),notAfter 在 398 天以内,SAN 含实际访问的所有域名。
2)协议版本与套件
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
nmap --script ssl-enum-ciphers -p 443 example.com
第一条应当握手失败(说明 TLS 1.1 已关闭);第二条列出全部可用套件,确认没有 RC4/3DES/CBC 老套件。
3)跳转与 HSTS
curl -I http://example.com
curl -sI https://example.com | grep -i strict-transport-security
第一条应返回 301 且 Location: https://example.com/;第二条应看到 max-age=。
4)混合内容
Chrome DevTools → Console 搜索 Mixed Content;或 curl -s https://example.com | grep -c "http://" 抽查页面里残留的 http 资源,逐个改为相对协议或 https。
5)第三方评级
SSL Labs:https://www.ssllabs.com/ssltest/analyze.html?d=example.com,目标 A 或 A+。若因 TLS 1.0 或 RC4 掉到 B,回看第三节的 ssl_protocols 与 ssl_ciphers。
6)小程序与 iOS 真机
微信开发者工具 → 详情 → 域名信息,确认 request 合法域名已生效;再用真机预览调用一次 wx.request,观察是否还有 fail ssl hand shake error。iOS 端用 Safari 打开同一域名,确认无证书警告,App 内 ATS 才会放行。
7)续期演练
把证书替换流程写成脚本并演练一次:备份旧 fullchain → 替换 → nginx -t → reload → 复查 Verify return code。避免到期当天手忙脚乱。
常见问题
免费证书(Let’s Encrypt)能用于微信小程序吗?
可以。小程序校验的是证书是否由受信任 CA 签发、域名是否匹配、TLS 版本是否满足要求,与证书是否付费无关。Let’s Encrypt 已被主流根信任库收录,唯一代价是 90 天有效期,必须配置自动续期(如 acme.sh --cron 或 certbot renew 加 reload 钩子),否则到期当天小程序会整体不可用。
证书为什么不是一年有效期了?398 天怎么算?
CA/Browser Forum 规定公有 CA 签发的 TLS 服务器证书单次有效期上限为 398 天,从 notBefore 到 notAfter 计算(含 30 天续期缓冲的行业惯例),2020 年 9 月起替代原来的 825 天。后续将分阶段缩短至 200 天、100 天、47 天。所谓“多年期证书”实际是每年重新签发一张,续期工作不会省。
一张证书能同时覆盖 example.com 和 www.example.com 吗?
能,但必须把两个域名都写进 SAN。只签 example.com 时访问 www.example.com 会报 ERR_CERT_COMMON_NAME_INVALID。通配符 *.example.com 不覆盖裸域,也不覆盖 a.b.example.com,实际部署时建议“通配符 + 裸域”一起签,或直接签多域名 SAN 证书。
证书已经装好,浏览器正常,为什么小程序还是握手失败?
最常见是证书链不完整:浏览器会通过 AIA 自动下载中间证书,小程序与 iOS 不会。用 openssl s_client -connect 域名:443 -servername 域名 -showcerts 看是否只返回一张证书;若是,把域名证书与中间证书拼成 fullchain 并在 ssl_certificate 中引用。其次是服务器仍开启 TLS 1.0/1.1,需改为 TLSv1.2 TLSv1.3。
更换证书时怎么做到不中断?
先把新证书、私钥、fullchain 上传到新路径,用 nginx -t 校验通过后执行 nginx -s reload(平滑重载,不断连接);确认新证书生效(复查 Verify return code 与 notAfter)后再删除旧文件。切勿直接覆盖正在使用的文件后重启,一旦私钥不匹配会导致整站 443 不可用。
HTTP 跳转 HTTPS 用 301 还是 302?
用 301(永久重定向)。302 是临时跳转,搜索引擎不会传递权重,浏览器也不会缓存跳转关系。配置示例见第三节的 return 301 https://$host$request_uri;;启用 HSTS 后浏览器会强制走 HTTPS,此时建议先用较小 max-age 观察,确认无 HTTP 依赖后再加大。