跳到主要内容
ssl证书按装

微信小程序 HTTPS 与 SSL 证书申请安装配置全指南:Nginx/Apache/Tomcat 实操与排错

微信小程序 HTTPS 与 SSL 证书申请安装配置全指南:Nginx/Apache/Tomcat 实操与排错 — 微信小程序 HTTPS 与 SSL 证书申请安装配置全指南:Nginx/Apache/Tomcat 实操与排错

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

微信小程序从上线起就要求服务器域名使用 HTTPS,且 TLS 版本需 1.2 及以上,域名必须为受信任 CA 签发的证书,不能直接用 IP。浏览器侧也在持续弱化 HTTP:地址栏标记“不安全”、部分 API 仅限安全上下文。广告劫持的根因是 HTTP 明文可被中间人插入脚本或跳转,HTTPS 通过 TLS 加密通道和证书身份校验同时解决机密性与完整性问题。实际故障多不是“证书没装”,而是证书链不完整、域名/SAN 不匹配、证书过期、服务器时间偏差、安全组未放行 443、SNI 未命中或 CDN 回源仍为 HTTP。公开信任 TLS 证书最长有效期已缩短为 398 天,Let’s Encrypt 免费证书有效期为 90 天,必须建立续期机制。排查前先确认基础环境:执行 openssl version、curl -V 查看是否支持 TLS 1.2/1.3;执行 ss -lntp | grep ':443' 确认监听;云上 ECS 需在安全组放行 443/tcp,Linux 本机防火墙执行 firewall-cmd --add-service=https --permanent && firewall-cmd --reload 或 ufw allow 443/tcp。若 80 端口未放行,HTTP-01 验证会失败;若使用 DNS-01,则要保留 TXT 记录至签发完成。理解这些根因后,后面的申请、部署和验证才有明确目标。

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

按验证等级分,DV 只验证域名控制权,通常几分钟签发,适合个人站点、API、小程序后端和大多数企业业务;OV 需要验证企业身份,通常 3—5 个工作日,适合对组织真实性有要求的企业门户;EV 增加更严格的组织验证,但主流浏览器已不再在地址栏常驻展示绿色公司名,因此不要只为“地址栏显示公司名”购买 EV。按覆盖范围分,单域名证书只保护一个精确域名;多域名证书通过 SAN 保护多个域名;通配符证书 *.example.com 只匹配一级子域名,如 a.example.com,不匹配 a.b.example.com。微信小程序请求的域名必须写入证书 SAN,常见做法是同时签发 example.com 与 www.example.com。查看证书信息可执行 openssl x509 -in cert.pem -noout -subject -issuer -dates -ext subjectAltName。选型建议:个人博客和小程序接口优先 DV;多子域业务选通配符;域名分散且不想维护多张证书选多域名;金融、电商若合规要求组织验证再选 OV/EV。注意证书有效期:公开信任 TLS 证书最长 398 天,Let’s Encrypt 为 90 天,商业证书也不再是“一年免管”,必须配置自动续期和到期监控。不要购买“永久证书”,公开信任 CA 不存在永久有效证书。

申请前准备:域名、TXT 解析、CSR 与安全组 443

申请前准备四件事:域名管理权限、可用的 DNS TXT 解析、CSR/私钥、以及 443 入站规则。DNS-01 验证通常添加 _dnsauth.example.com 的 TXT 记录,值以 CA 控制台显示为准;添加后用 dig +short TXT _dnsauth.example.com 或 nslookup -type=TXT _dnsauth.example.com 检查传播。生成私钥和 CSR 可直接执行:openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com'。现代证书依赖 SAN,单靠 CN 不够;多域名需在 CA 下单时填写 SAN 列表。检查 CSR:openssl req -in example.com.csr -noout -text,确认 CN 与 SAN 无误。私钥权限设为 chmod 600 example.com.key,不要上传到网站根目录。云服务器需确认安全组入方向放行 443/tcp,若用 HTTP-01 还需 80/tcp;本机执行 firewall-cmd --add-service=https --permanent && firewall-cmd --reload,Ubuntu 可执行 ufw allow 443/tcp。若使用 CDN/WAF,先确认回源协议和证书部署位置,避免“边缘 HTTPS、回源 HTTP”导致源站校验失败。准备完成后,再进入签发环节。

完整实操步骤:用 Certbot/acme.sh 申请并部署证书

以 Ubuntu + Nginx 为例,安装 Certbot:sudo apt update && sudo apt install -y certbot python3-certbot-nginx。Nginx 站点已能通过 80 访问时,执行 sudo certbot --nginx -d example.com -d www.example.com --redirect,Certbot 会自动写入证书路径并配置 301。若不想改 Nginx,用 webroot:sudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com。使用 acme.sh 时:curl https://get.acme.sh | sh -s email=admin@example.com,然后 ~/.acme.sh/acme.sh --issue -d example.com -d www.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 'systemctl reload nginx'。商业证书则把 CA 返回的服务器证书与中间证书合并:cat example.com.crt intermediate.crt > fullchain.crt,私钥单独保存。验证续期:sudo certbot renew --dry-run;acme.sh 默认 cron 自动续期,可用 ~/.acme.sh/acme.sh --cron 测试。Let’s Encrypt 有效期 90 天,商业公开信任证书最长 398 天,建议在到期前 30 天完成续期并 reload 服务。

配置示例:Nginx、Apache、Tomcat 与 HTTP 301 跳转

Nginx 最小可用配置如下,80 端口强制 301,443 加载 fullchain 与私钥,启用 TLS 1.2/1.3:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers off;
    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    location / { root /var/www/html; index index.html; }
}

Apache 在 80 虚拟主机中写 Redirect permanent / https://example.com/,443 虚拟主机启用 SSLEngine on,配置 SSLCertificateFile /etc/ssl/certs/fullchain.crt、SSLCertificateKeyFile /etc/ssl/private/example.com.key,并加载 mod_ssl。Tomcat 在 server.xml 中配置 443 Connector:<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true' keystoreFile='/opt/tomcat/conf/example.com.pfx' keystoreType='PKCS12' keystorePass='***' />,PFX 可用 openssl pkcs12 -export -in fullchain.crt -inkey example.com.key -out example.com.pfx 生成。IIS 则导入 PFX 后在站点绑定 443。配置后先执行 nginx -t 或 apachectl configtest,再 reload。注意 301 后页面内资源也必须使用 HTTPS,否则会出现混合内容警告。

对比表格:DV/OV/EV 与单域名/多域名/通配符及有效期

下表把常见证书类型、验证方式、签发时间和有效期放在一起,便于按业务选型。重点注意:公开信任 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天,不存在“永久有效”的公开信任证书。

类型 验证内容 典型签发时间 适用场景 有效期/续期
DV 单域名 域名控制权 几分钟至数小时 个人站、小程序 API、测试环境 最长 398 天;Let’s Encrypt 90 天
DV 多域名(SAN) 多个域名控制权 几分钟至数小时 多域名共用一个入口 同上,按 SAN 数量计价
DV 通配符 域名控制权 几分钟至数小时 大量一级子域名 同上,不覆盖多级子域
OV 域名+企业身份 3—5 个工作日 企业门户、合规要求 最长 398 天,需重新验证
EV 严格组织验证 5—10 个工作日 金融、电商等高信任场景 最长 398 天,地址栏展示有限
Let’s Encrypt 域名控制权 自动签发 自动化部署、免费证书 90 天,建议 60 天续期

验证证书实际有效期可执行 openssl x509 -in fullchain.pem -noout -dates,查看 SAN 可加 -ext subjectAltName。选型时不要只看价格:小程序和 API 只要受信任 DV 即可;多级子域不要误买通配符;OV/EV 的额外价值在组织验证和合规审计,而不是“更快的 HTTPS”。

常见错误排查:真实报错与修复命令

以下报错在证书部署中最常见,按“先链、再名、再端口、后协议”的顺序排查。

  • curl: (60) SSL certificate problem: unable to get local issuer certificate:证书链不完整。Nginx 必须使用 fullchain.pem,而不是只含站点证书的 cert.pem;商业证书执行 cat example.com.crt intermediate.crt > fullchain.crt。验证:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,输出中应包含中间证书,最后出现 Verify return code: 0 (ok)。
  • nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed:路径错误、权限不足或文件格式不对。执行 ls -l /etc/nginx/ssl/fullchain.pem 和 openssl x509 -in fullchain.pem -noout -text;Nginx worker 用户需可读私钥,权限建议 600 且属主 root。
  • NET::ERR_CERT_COMMON_NAME_INVALID:域名与证书 SAN 不匹配。用 openssl x509 -in cert.pem -noout -ext subjectAltName 检查;给 www.example.com 签发时 SAN 必须包含它,不能只写 CN。
  • 微信小程序 request:fail ssl handshake error:检查 TLS 1.2+、证书链、443 安全组、域名是否已配置为合法域名。执行 openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null,若握手失败先修链和协议。
  • SSL_ERROR_RX_RECORD_TOO_LONG:443 端口返回了明文 HTTP,通常是 listen 443 缺少 ssl 或端口被其他服务占用。执行 curl -I http://example.com:443 和 ss -lntp | grep ':443' 定位。
  • certbot: Problem binding to port 80: Could not bind to IPv4 or IPv6:80 被 Nginx/Apache 占用。用 ss -lntp | grep ':80' 查看,改用 --webroot 或 --nginx 插件,不要强行停止生产服务。

效果验证:命令行、浏览器与微信开发者工具

部署完成后按以下顺序验证。第一,HTTP 跳转:curl -I http://example.com 应返回 301 且 Location: https://example.com/。第二,HTTPS 状态:curl -I https://example.com 应返回 200/301,无证书警告。第三,证书链与协议:openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null,确认 Verify return code: 0 (ok);再用 -tls1_3 测试现代协议。第四,查看证书有效期和 SAN:openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -subject -issuer -dates -ext subjectAltName。第五,端口监听:ss -lntp | grep ':443',确认 Nginx/Apache/Tomcat 监听。第六,续期检查:sudo certbot renew --dry-run;证书剩余 30 天可用 openssl x509 -checkend 2592000 -noout -in fullchain.pem 做监控。浏览器侧确认锁标、无混合内容;微信开发者工具用 wx.request({url:'https://example.com/api'}) 测试,真机再测一次。若使用 CDN,刷新证书并确认回源为 HTTPS。最后用 SSL Labs 或 testssl.sh 做评级,目标至少 A,禁用 TLS 1.0/1.1 和弱套件。

常见问题

以下问题覆盖小程序 HTTPS、证书有效期、链不完整和续期操作,可作为上线前检查清单。

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

不必须。受信任 CA 签发的 DV 证书即可,关键是域名匹配、证书链完整、TLS 1.2 及以上、443 可访问,并已在小程序后台配置合法域名。

SSL 证书最长有效期是多久?

公开信任 TLS 证书最长 398 天;Let’s Encrypt 有效期为 90 天。商业证书也不再是一年免管,应配置自动续期和到期告警。

安装了证书仍提示不安全,优先查什么?

先查证书链是否完整,再查域名/SAN 是否匹配、证书是否过期、服务器时间是否准确、443 安全组是否放行,以及 CDN 回源是否仍为 HTTP。

HTTP 301 跳转如何配置?

Nginx 使用 return 301 https://$host$request_uri;;Apache 使用 Redirect permanent / https://example.com/。跳转后确认页面资源全部走 HTTPS,避免混合内容。

通配符证书能保护多级子域名吗?

*.example.com 只匹配一级子域名,如 a.example.com,不匹配 a.b.example.com。多级子域需单独签发或加入 SAN。

证书续期后需要重启服务吗?

需要让服务重新加载证书。Nginx 执行 systemctl reload nginx;acme.sh 安装证书时用 --reloadcmd 'systemctl reload nginx' 自动完成。

内容审核

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