SSL 证书安装教程 error 全解析:按报错码定位的 8 步排障流程
SSL 证书安装教程里出现的 error,多数不是证书本身签发失败,而是服务端没有下发完整证书链或 Nginx 的 ssl_certificate 指向了 cert.pem 而不是 fullchain.pem,用 openssl verify -CAfile fullchain.pem cert.pem 一条命令即可判定。 curl 退出码可以快速分层:60 是证书校验失败、35 是 TLS 握手失败、28 是超时(与证书无关)、7 是 TCP 连接被拒,先用 curl -vI https://域名 --connect-timeout 10 -m 30 拿到退出码再动手。 Nginx 1.26 上正确的两行是 ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem 与 ssl_certificate_key …/privkey.pem,ssl_protocols 建议写 TLSv1.2 TLSv1.3,改完执行 nginx -t && systemctl reload nginx。 验证是否真的生效:echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep -c BEGIN CERTIFICATE 返回 2 或 3 表示链完整,curl -o /dev/null -s -w '%{ssl_verify_result}' 返回 0 表示校验通过。 Let's Encrypt 证书有效期 90 天,certbot renew --dry-run 应在到期前 30 天跑一次;商业 DV 证书常见价格区间 50–400 元/年,OV 约 800–2500 元/年,价格随渠道浮动。
装完 SSL 证书还是报 error:先分清这 6 类根因
装完证书浏览器仍报 error,第一步不是重装证书,而是归因:报错文本里出现 “error” 不等于证书有问题。先按下面这张表做一次 60 秒定性,再决定往哪个方向深挖。
| 根因类别 | 典型报错文本 / 退出码 | 一条命令定性 |
|---|---|---|
| 1. 网络与端口 | curl 退出码 28 / 7 | curl -Iv --connect-timeout 5 https://域名; echo "exit=$?" |
| 2. 证书链不完整 | unable to get local issuer certificate / PKIX path building failed / SEC_E_UNTRUSTED_ROOT (0x80090325) | openssl s_client -connect 域名:443 -servername 域名 -showcerts |
| 3. 路径与权限 | cannot load certificate … Permission denied (13) | namei -l /etc/nginx/ssl/fullchain.pem |
| 4. 协议 / SNI 不匹配 | wrong version number / protocol version / hostname mismatch | openssl s_client -connect 域名:443 -servername 域名 -tls1_2 |
| 5. 系统时钟偏差 | certificate is not yet valid / certificate has expired | timedatectl status |
| 6. 文件格式错误 | error:0909006C:PEM routines:get_name:no start line | openssl x509 -in 证书文件 -noout -subject |
第一类:带 error 但不是证书问题。据 curl 官方 manpage 的 EXIT CODES 定义,28 是 Operation timed out(DNS 解析慢、路由不通、被丢包),7 是 Failed to connect(443 未监听或被安全组拦截)。这两类改证书只会浪费时间:
# 退出码 28 查 DNS 与网络可达性;退出码 7 查监听端口与安全组
curl -Iv --connect-timeout 5 https://example.com; echo "exit=$?"
ss -lntp | grep ':443' # 无输出说明进程未监听,与证书无关
getent hosts example.com # 确认解析到的 IP 是目标服务器
第二类:证书链不完整(最高频的真·证书错误)。服务端只下发叶子证书时,客户端找不到中间证书,各平台报错不同:OpenSSL 报 unable to get local issuer certificate,Java 报 PKIX path building failed,Windows Schannel 报 SEC_E_UNTRUSTED_ROOT (0x80090325)。据 Let’s Encrypt 文档,/etc/letsencrypt/live/<域名>/ 下 cert.pem 只是叶子证书,fullchain.pem 才是叶子+中间证书——Nginx 的 ssl_certificate 必须指向 fullchain.pem。验证链长度应为 2:
openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null
| grep -c 'BEGIN CERTIFICATE' # 输出 1 说明缺中间证书,应为 2
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
第三类:文件路径与权限。Nginx worker 以 nginx 用户运行,对私钥目录无读权限时 nginx -t 直接失败。certbot 默认把 privkey.pem 设为 0600、其余文件 0644、live/archive 目录 0755,一旦改过属主或用了 700 目录就会踩坑:
namei -l /etc/letsencrypt/live/example.com/fullchain.pem # 逐级检查目录权限
chmod 755 /etc/letsencrypt/live /etc/letsencrypt/archive
chmod 640 /etc/letsencrypt/archive/example.com/privkey*.pem
chown root:nginx /etc/letsencrypt/archive/example.com/privkey*.pem
nginx -t && systemctl reload nginx
第四类:协议、密码套件与 SNI 不匹配。wrong version number 有两种常见来源:一是把纯 HTTP 的 80 端口当 HTTPS 连(服务器回的是 HTTP 明文),二是客户端与服务端 TLS 版本无交集。Nginx 1.23.4 起 ssl_protocols 默认值已变为 TLSv1.2 TLSv1.3,若只留 TLSv1.3,Android 5、Java 7 等只支持 TLSv1.2 的客户端会直接握手失败;这些老客户端往往还不发 SNI,于是拿到默认站点的证书并报 hostname mismatch——解决办法是给该 IP 配一张默认证书,而不是改新证书。
第五类:系统时钟偏差。服务器时间落在证书 notBefore/notAfter 之外,就会报 not yet valid 或 has expired,哪怕证书本身完全有效。据 Mozilla 的 CA 要求实践,校时偏差建议控制在 5 分钟内:
timedatectl status # 关注 "System clock synchronized: yes"
chronyc tracking # 查看 System time 偏移量(秒)
timedatectl set-ntp true # 未同步时启用 NTP
第六类:文件格式错误。把 DER 或 PKCS#12 文件直接改名成 .pem 是最隐蔽的坑,OpenSSL 会报 error:0909006C:PEM routines:get_name:no start line(OpenSSL 3.x 与 1.1.1 文本一致)。用 file 判断真实编码,再做一次转换,不要靠改后缀:
file cert.der # 输出 "data" 多为 DER;"ASCII text" 才是 PEM
openssl x509 -in cert.der -inform DER -out cert.pem -outform PEM
openssl x509 -in cert.pem -noout -subject -dates # 转换后立即校验
如果六类都排除了,下一步不是重装,而是抓一次完整握手:openssl s_client -connect 域名:443 -servername 域名 -state -tlsextdebug,看握手停在 ClientHello、Certificate 还是 Alert 阶段,据此进入按报错码定位的后续步骤。
8 步实操:从一条报错定位到修复上线
把前面几节识别出的报错码落到操作上,就是下面这条固定流水线。按顺序执行,每一步的输出都留档,才能在改完配置后证明”确实修好了”。这也是处理 ssl证书 安装教程 error 类问题最省时间的方式——先定位层级,再动配置文件。
-
固化现场。先别急着改 nginx.conf,把当前握手过程完整抓下来:
# -vI 只发 HEAD 请求,输出完整握手细节;2>&1 把 stderr 一起重定向 # --connect-timeout 10 限制 TCP 连接阶段,-m 30 限制整个请求总时长 curl -vI https://example.com --connect-timeout 10 -m 30 2>&1 | tee /tmp/ssl-debug-$(date +%F).log echo "curl exit code: $?" # 退出码是第 2 步判定的核心依据 -
判定层级。curl 的退出码直接告诉你该看哪一层;浏览器侧打开 DevTools 的 Security 面板,错误串含义不同:
curl 退出码 典型报错关键字 问题层级 跳转 60 unable to get local issuer certificate / self-signed certificate in certificate chain 证书链不完整或根不受信 第 3、4 步 35 sslv3 alert handshake failure / no protocols available 协议版本或加密套件不匹配 查 ssl_protocols、ssl_ciphers 28 Operation timed out after 30001 milliseconds 网络、防火墙或 CDN 回源 查安全组、回源 443 7 Failed to connect to example.com port 443: Connection refused 端口未监听 ss -lntp | grep 443浏览器报
NET::ERR_CERT_AUTHORITY_INVALID多为缺中间证书,NET::ERR_CERT_DATE_INVALID则是本机或服务器时间偏差(用timedatectl核对 NTP 同步状态)。 -
抓服务端真实下发的链。不要只看磁盘上的文件,要看线上到底发了几张:
# -servername 显式传 SNI(OpenSSL 1.1.1 起也会自动推断,但显式写更稳) openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE'返回
1说明只下发了叶子证书,必须改为下发 fullchain。据 Let’s Encrypt 文档,cert.pem是叶子证书,chain.pem是中间证书,fullchain.pem才是两者拼接、应当配置到服务端的那一个。 -
本地离线校验。不依赖网络,可排除客户端环境影响:
# Debian/Ubuntu 的根证书包;RHEL 系换成 /etc/pki/tls/certs/ca-bundle.crt openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem # 期望输出:cert.pem: OK -
比对配置与文件。
nginx -T 2>/dev/null | grep -n ssl_certificate # -T 输出合并后的完整配置,含 include 内容nginx 的
ssl_certificate必须指向fullchain.pem,ssl_certificate_key指向私钥。Apache 以 2.4.8 为分界:2.4.8 及以上SSLCertificateFile直接指向 fullchain.pem;2.4.8 以下必须额外写SSLCertificateChainFile,否则同样只发叶子证书。Mozilla SSL Configuration Generator 的推荐配置也是这一组合。 -
灰度重载。用 reload 而非 restart,现有连接不中断:
nginx -t && systemctl reload nginx # 语法检查通过才 reload # 立刻复查,证书数量应从 1 变成 2 openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE' -
多客户端交叉验证。单一客户端通过不代表全部通过,因为信任库和 SNI 行为不同:
客户端 信任库来源 典型坑 curl(OpenSSL 后端) 系统 ca-certificates 缺中间证书报 60 Chrome / Firefox 系统库 + 浏览器内置根 Firefox 有独立根库,结果可能不同 Java 客户端 $JAVA_HOME/lib/security/cacerts老 JDK 不认新根证书 微信小程序 微信客户端内置 要求 TLS 1.2+,不信任自签证书 -
加监控防复发。把一次性排障变成常态检查:
#!/bin/bash # /etc/cron.daily/ssl-expiry-check.sh,chmod +x 后由 cron 每天执行 end=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2) days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 )) for t in 30 14 7; do # 剩余天数低于阈值就发信 [ "$days" -le "$t" ] && echo "example.com 证书剩余 ${days} 天" | mail -s "[告警] SSL 证书即将到期 (阈值 ${t} 天)" ops@example.com done脚本里的
date -d是 GNU coreutils 语法,macOS 需换date -j -f "%b %d %T %Y %Z"。整条流程走完后,再回到开头那条 curl 命令做前后对比,日志里证书链长度与退出码的变化就是修复证据——这也正是每次处理 ssl证书 安装教程 error 都值得留下日志的原因。
配置与命令示例:OpenSSL 3.0 / Nginx 1.26 / Apache 2.4.58
与其在报错后逐行猜,不如先用一段”最小可用配置”把变量压到最少:只保留证书链、私钥、协议版本、密码套件四要素,跑通后再加 OCSP、HSTS 等增强项。下面片段基于 Nginx 1.26 与 Apache 2.4.58 实测语法,可直接粘贴替换域名路径。
# /etc/nginx/conf.d/example.com.conf —— Nginx 1.26 最小可用 TLS 片段
server {
listen 443 ssl;
http2 on; # 1.25.1 起取代 listen 443 ssl http2 写法
server_name example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 必须含中间证书
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; # 权限建议 600
ssl_protocols TLSv1.2 TLSv1.3; # 1.23.4 之前的默认值含 TLSv1/1.1,务必显式声明
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:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off; # Mozilla intermediate 推荐 off,让客户端选更快的套件
}
上面的 ssl_ciphers 取值直接来自 Mozilla SSL Configuration Generator 的 “Intermediate” 档(兼容 TLS 1.2 客户端,目标为 Firefox 27、Chrome 31、Android 4.4.2 及以上)。ssl_prefer_server_ciphers 的 Nginx 默认值本来就是 off,写出来是为了防止被上游 include 的旧配置覆盖——这类”被覆盖”是 ssl证书 安装教程 error 类问题里最常见的隐形原因之一。
要让 OCSP 装订真正生效,光开三行不够:Nginx 需要自己解析 OCSP 响应者域名,没有 resolver 时会静默失败(日志里只在 debug 级别出现 “no resolver defined to resolve”),表现为 openssl s_client -status 一直返回 “OCSP response: no response sent”。
# 接在上面的 server 块内
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; # 注意是 chain 而非 fullchain
resolver 223.5.5.5 119.29.29.29 valid=300s; # 缺少此行 stapling 会静默失败
resolver_timeout 5s;
需要提醒:据 Let’s Encrypt 官方公告,2025 年起新签发证书已不再写入 OCSP URL,其 OCSP 响应服务亦已下线,因此对 Let’s Encrypt 证书而言这三行只剩余”兼容其他 CA”的意义;若你仍在使用含 OCSP 的商业证书,这段配置才产生实际收益。
# Apache 2.4.58 —— httpd-ssl.conf
SSLEngine on
SSLCertificateFile /path/fullchain.pem # 2.4.8 起此文件可直接拼接服务器证书+中间证书
SSLCertificateKeyFile /path/privkey.pem
# SSLCertificateChainFile /path/chain.pem # 仅 2.4.8 之前需要;现已 deprecated,重复配置反而可能报错
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
两个 Web 服务器的指令映射关系如下,迁移或对照文档时可少走弯路:
| 能力 | Nginx 1.26 | Apache 2.4.58 | 默认值 |
|---|---|---|---|
| 证书链文件 | ssl_certificate(含链) |
SSLCertificateFile(含链) |
无,必填 |
| 协议版本 | ssl_protocols |
SSLProtocol |
Nginx 1.23.4 前含 TLSv1/1.1;Apache 需显式排除 |
| 套件偏好 | ssl_prefer_server_ciphers |
SSLHonorCipherOrder |
均为 off |
| OCSP 装订 | ssl_stapling |
SSLUseStapling |
均为 off |
配置写完后先离线验链,再上客户端验证。OpenSSL 3.0 的 verify 返回码是最快的定位手段:返回 0 (ok) 说明链完整,返回 error 20 at 0 depth lookup: unable to get local issuer certificate 则几乎可以断定漏配了中间证书。
# 1) 离线验链:-untrusted 传入中间证书,-CAfile 用系统根库
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted /etc/letsencrypt/live/example.com/chain.pem
/etc/letsencrypt/live/example.com/cert.pem
# 2) 看主体、签发者与有效期(Let's Encrypt 单张有效期 90 天)
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
# 3) 确认 SAN 覆盖了实际访问的域名(CN 字段早已不被浏览器采信)
openssl x509 -in cert.pem -noout -text | grep -A1 'Subject Alternative Name'
# 4) 客户端视角:ssl_verify_result 为 0 才代表校验通过
curl -o /dev/null -s -w '%{http_code} %{ssl_verify_result} %{time_total}n' https://example.com
# 5) 锁定 TLS 1.2 测试旧客户端兼容性(若此处握手失败,说明套件或协议被裁得过狠)
curl --tlsv1.2 --tls-max 1.2 -I https://example.com
最后别把续期链路留到 90 天后再验证。Certbot 2.x 提供 --dry-run 与 --deploy-hook,前者用 staging 环境模拟一次完整签发,后者保证续期后真正 reload 进程——只续期不 reload,是”证书明明换了浏览器仍报过期”的典型成因。
# 演练:输出 Congratulations, all simulated renewals succeeded 才算链路正常
certbot renew --dry-run --cert-name example.com
# 续期成功后自动重载(certbot 2.x 写法,写入 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh)
#!/bin/sh
systemctl reload nginx
证书链打包方式与工具选型对比表
为什么 Nginx 里明明配了证书,浏览器还是报 NET::ERR_CERT_AUTHORITY_INVALID?九成是证书链没拼对。浏览器不认”单独一张叶子证书”——它需要服务端把中间证书一并下发,才能沿 叶子 → 中间 → 根 走到系统信任库。据 Let’s Encrypt 文档,certbot 在 /etc/letsencrypt/live/<域名>/ 下会生成四个文件,形态和用途完全不同:
| 文件 | 内容 | 正确用途 | 常见误用与后果 |
|---|---|---|---|
cert.pem |
仅叶子(终端实体)证书 | 离线校验、单独交给老版本 IIS | 直接配到 Nginx → 缺中间证书,报链不完整 |
chain.pem |
仅中间证书(不含根) | Apache 2.4.7 及更早的 SSLCertificateChainFile |
当成站点证书配 → 主体名不匹配 |
fullchain.pem |
cert.pem + chain.pem 顺序拼接 |
Nginx、Apache 2.4.8+、HAProxy 一律用它 | 顺序颠倒 → 链校验失败 |
privkey.pem |
私钥(权限 0600) | 仅 ssl_certificate_key |
误上传到仓库 → 必须立即吊销重签 |
# 1) 确认 certbot 产物(默认路径 /etc/letsencrypt/live/<域名>/)
ls -l /etc/letsencrypt/live/example.com/
# 2) 手工拼接时顺序必须是「叶子 → 中间」,颠倒会触发
# curl: (60) SSL certificate problem: unable to get local issuer certificate
cat cert.pem chain.pem > fullchain.pem
# 3) Nginx(任意 1.x 版本,含 1.11 之后)
# ssl_certificate 必须只指向 fullchain.pem 一个文件
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
# 4) Apache 2.4.8+:一个文件搞定,SSLCertificateChainFile 已无需再写
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
# Apache 2.4.7 及更早(以及部分老版本 IIS 的中间证书导入框)才需要拆开:
# SSLCertificateFile .../cert.pem
# SSLCertificateChainFile .../chain.pem
Nginx 在 1.11.0 之后把 ssl_certificate 的语义改为”每种密钥类型一个文件”(RSA/ECDSA 双证书场景),旧的多行拼接写法不再被推荐,写错顺序时链校验会直接失败。这正是很多 ssl证书 安装教程 error 帖子里”配置一模一样却不生效”的根因。
续期后还要手工重拼 fullchain 吗?不建议。手工 cat 简单,但 90 天续期后容易忘记重做;用 ACME 客户端自动产出 fullchain(certbot 每次续期都会重写这四个文件),或让 Nginx 直接指向 live 目录的软链,才是长期方案。
- Wildcard 通配符 SSL 证书安装部署续费申请
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
| 排查工具 | 最适合回答的问题 | 依赖 / 耗时 | 典型命令 |
|---|---|---|---|
openssl s_client |
服务端实际下发了哪些证书、顺序对不对 | 零依赖;输出冗长,需配合管道过滤 | openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null |
openssl verify |
本地证书链能否离线走通(排除网络/代理干扰) | 零依赖;毫秒级 | openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem |
curl |
握手是否成功、退出码与总耗时 | 系统自带;秒级 | curl -o /dev/null -sS -w '%{http_code} %{time_total}n' https://example.com |
| SSL Labs 在线检测 | 协议/套件/链完整性的评分报告 | 需公网可达;排队常达数十秒 | 网页提交域名,看 “Chain issues” 一栏 |
certbot renew --dry-run |
续期流程能否跑通 | 需 ACME 可达;分钟级 | certbot renew --dry-run --cert-name example.com |
nmap --script ssl-enum-ciphers |
协议版本与套件盘点(是否残留 TLS 1.0) | 需安装 nmap;十秒级 | nmap --script ssl-enum-ciphers -p 443 example.com |
线上问题先查哪个?优先 openssl s_client,但务必带 -servername 指定 SNI——省略该参数时服务器会返回默认站点的证书,很容易被误判成”证书配错了”。据 OpenSSL 官方手册,-servername 用于发送 TLS SNI 扩展,多域名共用同一 IP 时它是唯一能拿到正确证书的方式。本地文件问题则用 openssl verify 离线跑,按 RFC 5280 的证书路径验证逻辑给出结论,不受 DNS 与代理影响。
| 证书类型 | 参考价格 | 有效期 | 签发/审核时长 |
|---|---|---|---|
| Let’s Encrypt DV(ACME) | 免费 | 90 天,需自动续期 | 通常 10–60 秒 |
| 商业 DV | 约 50–400 元/年 | 常见 1 年 | 分钟级,仅域名验证 |
| OV | 约 800–2500 元/年 | 1 年 | 人工审核 1–3 个工作日 |
| EV | 约 2000–8000 元/年 | 1 年 | 审核 3–7 个工作日 |
价格随渠道、年限与品牌浮动,仅作量级参考;类型只影响身份审核深度,不改变链打包方式——OV/EV 同样是 fullchain 一套逻辑。若按报错码走到这一步仍不通,回头看 openssl verify 的输出:unable to get local issuer certificate 指向链缺中间证书,certificate has expired 则是时间问题,两者修复路径完全不同。
真实报错信息对照:12 条高频 error 与处置
把「装完证书打不开」直接丢进搜索引擎的人,多半会撞见一堆英文报错。在 ssl证书 安装教程 error 的排障场景里,报错原文比任何猜测都值钱——它已经告诉你是链断了、私钥错了还是根本没连上。下表按客户端归类 12 条最高频的原文,每条给出「一条命令定位根因」。
| 报错原文(可复制搜索) | 真实根因 | 一条命令定位 |
|---|---|---|
unable to get local issuer certificate |
服务端只发了叶证书,缺中间证书 | openssl s_client -connect 域名:443 -servername 域名 -showcerts 数 BEGIN CERTIFICATE 条数,1 即缺链 |
error:0A000086:SSL routines::certificate verify failed |
根 CA 不在本地信任库,或链在中间断开 | openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem |
error:0A000126:SSL routines::unexpected eof while reading |
对端提前 RST,多为端口不是 HTTPS 或中间设备拦截 | curl -vI https://域名:端口 看是否 TLS 握手阶段即断 |
wrong version number |
明文 HTTP 打到了 443,或反代把明文转给了 TLS 端口 | openssl s_client -connect 127.0.0.1:443 看首包是否为 TLS Record |
nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX() failed |
文件是 DER/PKCS#7,或首行不是 -----BEGIN CERTIFICATE----- |
head -1 证书文件 与 openssl x509 -in 证书 -noout -subject |
SSL_CTX_use_PrivateKey ... key values mismatch |
证书与私钥不是一对(换证时最常踩) | 见下方 MD5 对比命令 |
Permission denied (13) |
nginx worker 用户(默认 nginx/www-data)无读权限 |
sudo -u nginx cat privkey.pem |
NET::ERR_CERT_AUTHORITY_INVALID |
链不完整,或自签根未导入系统 | Chrome 开发者工具 → Security → 查看证书「颁发者」是否为中间 CA |
NET::ERR_CERT_COMMON_NAME_INVALID |
SAN 不含当前域名(CN 早已不参与校验) | openssl x509 -noout -ext subjectAltName -in fullchain.pem |
NET::ERR_CERT_DATE_INVALID |
证书过期,或客户端系统时间偏差 | openssl x509 -noout -dates -in fullchain.pem 与 date -u |
NET::ERR_SSL_PROTOCOL_ERROR |
协议版本被裁剪到浏览器不支持,或 443 上跑着明文服务 | openssl s_client -tls1_2 -connect 域名:443 |
javax.net.ssl.SSLHandshakeException: PKIX path building failed |
JDK 自带 cacerts 里没有该中间 CA |
优先服务端补 fullchain;其次 keytool -import -trustcacerts -cacerts -storepass changeit -alias 中间CA -file 中间CA.crt |
两条高频「配置级」验证命令,建议存进运维笔记:
# 1) Nginx 侧:必须指向 fullchain.pem,而不是 cert.pem(Let's Encrypt 的 cert.pem 只含叶证书)
# 据 Let's Encrypt 文档,cert.pem = 叶证书,chain.pem = 中间证书,fullchain.pem = 二者拼接
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
# 2) 证书与私钥配对校验(RSA 证书)
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in privkey.pem | openssl md5
# 两行输出必须完全一致;ECDSA 证书没有 modulus,改用:
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout -in privkey.pem | openssl md5
版本差异会误导人:OpenSSL 3.x 的报错带 error:0A0000xx 前缀,而 1.1.1 是 error:140xxxxx,搜旧文常对不上号;Nginx 1.25+ 对 ssl_certificate 的路径校验更严格,文件不存在直接 [emerg] 启动失败而非告警。
还有 4 条容易被误判成「证书问题」:java.security.cert.CertificateException: No subject alternative names present 是签发时 SAN 为空,只能重签;Go 的 x509: certificate signed by unknown authority 走系统信任库,Debian/Ubuntu 上先确认 ca-certificates 包为最新(update-ca-certificates);Windows 自带 curl 用 schannel 后端,报 schannel: SEC_E_UNTRUSTED_ROOT (0x80090325),行为与 OpenSSL 不同,必须用 Windows 机器单独验证一次;而 curl: (28) Operation timed out after 120001 milliseconds with 0 bytes received 与 curl: (7) Failed to connect 根本不在 TLS 层——先 ping 再 nc -vz 域名 443 查安全组与监听,排查时用 curl -vI https://域名 --connect-timeout 10 -m 30 显式限时(-m 默认 0 表示无限等待,卡死就是这么来的)。
怎么确认配置真的生效:5 种验证方法
改完配置、nginx -s reload、浏览器能打开,是不是就代表证书装好了?不一定。浏览器有缓存、有 HSTS、也常会”宽容”地自动补链,真正暴露问题的是命令行和异构客户端。下面 5 种验证方法按”从快到慢、从本机到多端”排列,建议每次变更后按顺序跑一遍——这也是把 ssl证书 安装教程 error 类故障挡在上线前的最后一道关卡。
方法一:数证书条数,确认链完整性。很多”安装成功但 App 报错”的根因,是服务器只下发了叶子证书。
# 统计服务器在握手中实际下发的证书条数
# 2 = 叶子证书 + 1 张中间证书;3 = 叶子 + 2 张中间(常见于交叉签名链)
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null
| grep -c 'BEGIN CERTIFICATE'
输出 2 或 3 为正常,输出 1 说明只发了叶子证书——配置没生效,或者改完没 reload(旧 worker 进程仍在用老配置)。据 Let’s Encrypt 文档,其签发的 fullchain.pem 本身即”叶子+中间”的完整链,Nginx 的 ssl_certificate 应指向它而不是 cert.pem。-servername 不能省,否则 SNI 虚拟主机可能返回默认站点的证书。
方法二:强制校验握手,让失败直接报错。默认的 s_client 即使校验失败也只打印不中断,容易误判。
# -verify_return_error:校验失败立即终止握手
# -CAfile 指定本机信任库(Debian/Ubuntu 路径;RHEL 系为 /etc/pki/tls/certs/ca-bundle.crt)
openssl s_client -connect example.com:443 -servername example.com
-verify_return_error -CAfile /etc/ssl/certs/ca-certificates.crt
结尾必须是 Verify return code: 0 (ok)。非 0 会直接给出原因码:21 (unable to verify the first certificate) = 缺中间证书;10 (certificate has expired) = 已过期;20 (unable to get local issuer certificate) = 根或中间不在信任库;62 = 主机名不匹配。这套错误码与 OpenSSL 文档的 X509_V_ERR_* 定义一一对应,可直接作为排障索引。
方法三:curl 量化,一次拿到状态码、校验码和握手耗时。
# 期望输出形如:200 0 0.087
# 第 2 列 ssl_verify_result:0 表示校验通过,非 0 即上面的原因码
curl -o /dev/null -s -w '%{http_code} %{ssl_verify_result} %{time_appconnect}n' https://example.com
同机房 time_appconnect 通常 30–200 ms;突然升到 1 s 以上,往往是证书链过大、未开启 session 复用,或 OCSP stapling 配置不当导致客户端自己去拉吊销状态。
方法四:在线检测 + 多端复核。把域名提交 Qualys SSL Labs,重点看是否出现 Chain issues: Incomplete;再用手机 4G、微信开发者工具、Java 客户端(默认 cacerts)各访问一次。不同信任库对中间证书缺失、SHA-1 签名、RSA 1024 位的容忍度差别很大,桌面浏览器能打开不代表 Java 或 Android 旧版本能打开。
方法五:配置自检与日志回溯。
# nginx -T 输出合并 include 后真正生效的配置,比只看单文件可靠
nginx -T | grep -E 'ssl_certificate|ssl_protocols|ssl_ciphers'
# 记录到期日,纳入监控告警
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -enddate
# 检索 SSL_ 前缀错误,如 SSL_CTX_use_PrivateKey_file() failed 表示私钥与证书不匹配
grep -E 'SSL_' /var/log/nginx/error.log | tail -n 20
| 方法 | 核心命令/动作 | 通过判据 | 主要能发现的问题 |
|---|---|---|---|
| 链完整性 | s_client -showcerts + grep -c |
计数为 2 或 3 | 只下发叶子证书、未 reload |
| 强校验握手 | -verify_return_error -CAfile |
Verify return code: 0 |
缺中间证书、过期、主机名不符 |
| curl 量化 | -w '%{ssl_verify_result}' |
200 0 + 合理耗时 |
校验失败、握手性能劣化 |
| 在线与多端 | SSL Labs + 4G/Java/小程序 | 无 Chain issues: Incomplete | 信任库差异、协议/套件不兼容 |
| 配置与日志 | nginx -T、error_log |
配置项符合预期、无 SSL_ 报错 | 私钥不匹配、生效配置被覆盖 |
把这五条写进发布后检查脚本:任一判据不满足即回滚,比事后从 ssl证书 安装教程 error 的报错码倒推要省事得多。Mozilla SSL Configuration Generator 生成的配置同样建议用它自带的验证命令复核一遍,因为模板与你的 Nginx/OpenSSL 版本未必完全对应。
修复耗时与成本:从 10 分钟到 2 个工作日
“修一个 SSL 报错到底要多久、要不要花钱?”——答案几乎完全取决于它落在哪一档:改配置、补证书链,还是必须重新签发。先按 curl 退出码分层,再对号入座,比在证书文件上反复重装快一个数量级。
第一档:纯配置类,10–30 分钟,成本为零。典型症状是路径写错、ssl_certificate 指向了 cert.pem 而不是 fullchain.pem、改完文件忘记 reload。这类问题不需要任何证书操作,一条 nginx -t 加一次平滑重载即可。注意 reload 不中断在途连接,restart 会,所以能用 reload 就别用 restart。
# 1. 打印实际生效的配置(-T 会展开 include),确认证书路径到底指向哪个文件
nginx -T 2>/dev/null | grep -nE 'ssl_certificate(_key)? '
# 2. 语法校验:退出码 0 才代表可以重载;非 0 会直接打印出错文件与行号
nginx -t; echo "exit=$?"
# 3. 平滑重载(nginx 1.x 全版本通用)
systemctl reload nginx # 等价写法:nginx -s reload
第二档:证书链缺失或格式转换,30–60 分钟。浏览器报 NET::ERR_CERT_AUTHORITY_INVALID 而 nginx -t 却通过,基本都是只下发了叶证书。fullchain 的拼接顺序必须是“服务器证书在前、中间证书在后”,顺序反了同样失败。排查要查服务端实际下发的链,而不是本地文件,并做一次多客户端复核(curl、openssl、浏览器各一次)。
# 查看线上真实下发的证书链,确认是否包含中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl crl2pkcs7 -nocrl -certfile /dev/stdin | openssl pkcs7 -print_certs -noout
# 本地校验:漏掉 -untrusted 会直接报 unable to get local issuer certificate
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted /etc/nginx/ssl/chain.pem /etc/nginx/ssl/cert.pem
# 期望输出:cert.pem: OK
# 用 certbot 托管的站点更省事:重新走一次 ACME 验证并刷新 live/ 下的软链
# 注意:--force-renewal 会占用 Let's Encrypt 同一注册域名每周 5 张重复证书的速率限制
certbot renew --force-renewal --cert-name example.com && systemctl reload nginx
第三档:必须重新签发。SAN 不含当前域名、私钥丢失、CA 根证书轮换(如 2021 年 DST Root CA X3 到期引发的老旧 Android 兼容问题)都属于这一类,耗时与费用差别极大。据 Let’s Encrypt 文档,其证书有效期为 90 天,ACME 验证通常 10–60 秒完成;商业证书的审核周期则由 CA 的尽调流程决定。
| 证书类型 | 重新签发耗时 | 费用参考(人民币) | 关键前提 |
|---|---|---|---|
| 免费 ACME(Let’s Encrypt / ZeroSSL) | 10–60 秒 | 0 元 | 90 天有效期,需自建续期与到期监控 |
| 商业 DV | 分钟级至数小时 | 约 50–400 元/年 | 仅验证域名控制权 |
| 商业 OV | 1–3 个工作日 | 约 800–2500 元/年 | 需提交营业执照等主体资料 |
| 商业 EV | 3–7 个工作日 | 约 2000–8000 元/年 | 需主体核验与电话/信函确认 |
表中价格为常见区间,随 CA 与代理商浮动,多年期通常有折扣,最终以实际报价为准。
真正烧钱的隐性成本在排查环节。如果一开始就按退出码分层定位,多数问题能在 15 分钟内收敛;反之直接在证书文件上反复重装、盲目重签,平均会多花 1–2 小时,甚至触发 CA 速率限制而被迫等待。
curl -sS -o /dev/null -w '%{http_code}n' https://example.com; echo "exit=$?"
# 60 = 证书校验失败,先查链是否完整、SAN 是否含该域名
# 35 = SSL 握手失败,先查协议版本与加密套件是否被对端拒绝
# 28 = 超时,先查 443 是否被防火墙/安全组拦截
# 7 = 连接被拒,先查进程是否监听、端口是否写错
验收标准只有两条:nginx -t 退出码为 0,且 openssl verify 返回 OK。两条都满足之前不要进入 reload 步骤,否则只是把错误从配置文件搬到了线上。
绝大多数是文件内容不是 PEM 格式或文件被截断。先执行 head -1 fullchain.pem 确认首行是 —–BEGIN CERTIFICATE—–,再用 openssl x509 -in fullchain.pem -noout -subject 验证能否解析。如果证书是从 Windows 导出或由 DER 改名而来,需要重新用 -outform PEM 转换后再 reload。
安装环节的报错类型基本一致,差别主要在文件形态和续期方式。Let's Encrypt 的 live 目录里 cert.pem 是叶子证书、fullchain.pem 才是完整链,误用 cert.pem 是最常见的报错来源;商业 DV 通常直接下发一个包含完整链的 crt 或 pem 文件,但有效期更长(1 年 vs 90 天),续期频率低、踩坑机会也少。选择时看的是运维自动化程度,而不是报错概率。
这个提示表示客户端不信任证书链的根。先用 openssl s_client -connect 域名:443 -servername 域名 -showcerts 看下发了几个证书,只有 1 个就说明缺中间证书,把 ssl_certificate 改成 fullchain.pem 并 reload。若链已完整仍报错,检查是否用了自签根证书,自签根必须手动导入客户端信任库。
不是。curl 退出码 28 表示操作超时,属于网络层问题,和证书校验无关。可以先用 telnet 域名 443 或 nc -vz 域名 443 确认端口可达,再执行 curl -vI https://域名 –connect-timeout 10 -m 30 缩短等待时间。真正的证书错误退出码是 60,TLS 握手错误是 35。
Java 使用自带的 cacerts 信任库,对证书链完整性的要求比浏览器更严格,服务端少下发一张中间证书时浏览器可能靠 AIA 自动补齐,Java 不会。正确做法是在服务端补齐 fullchain,而不是用 keytool -import 往每个 JDK 里塞证书,后者在容器化环境下无法维护。
先确认续期是否真的写入了新文件:openssl x509 -in /etc/letsencrypt/live/域名/fullchain.pem -noout -enddate,再看服务端实际下发的是否一致。常见原因是续期后没有触发 reload,可在 certbot 的 renew hook 里加 systemctl reload nginx;如果是 CDN 或负载均衡在前面,还需要在控制台重新上传证书。
Nginx 没有单独的中间证书指令,必须把叶子证书和中间证书拼在同一个 ssl_certificate 指向的文件里(即 fullchain.pem)。Apache 2.4.8 及以上可以直接用 SSLCertificateFile 指向 fullchain.pem,2.4.8 以下必须额外写 SSLCertificateChainFile 指向 chain.pem,漏写就会报 unable to get local issuer certificate。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。