ERR_SSL_PROTOCOL_ERROR 排查与修复指南:从 TLS 握手失败到 Nginx/Apache 配置
ERR_SSL_PROTOCOL_ERROR 是什么,不是什么
ERR_SSL_PROTOCOL_ERROR 是 Chromium 系浏览器(Chrome、Edge、Opera、部分 Electron 应用)在 TLS 握手阶段就失败时抛出的通用错误。关键词是握手阶段:TCP 连接建立成功了,但客户端和服务器没能就协议版本、加密套件或 SNI 达成一致,连接在 HTTP 请求发出之前就被掐断。
这直接决定了排查方向:
- 证书类错误(
NET::ERR_CERT_DATE_INVALID、ERR_CERT_AUTHORITY_INVALID、NET::ERR_CERT_COMMON_NAME_INVALID)说明握手已经走到证书校验这一步,协议本身是通的,问题在证书内容。 ERR_SSL_PROTOCOL_ERROR说明连证书都还没轮到校验。先去换证书、续期、重签,基本都是白费功夫。
Firefox 把同类问题拆得更细,看到下面这三条可以按同一套流程处理:
SSL_ERROR_NO_CYPHER_OVERLAP:没有共同加密套件。SSL_ERROR_RX_RECORD_TOO_LONG:对端返回的不是 TLS 记录,通常是明文 HTTP。SSL_ERROR_PROTOCOL_VERSION_ALERT:协议版本被对端拒绝。
根因归纳起来其实只有四类:443 端口上跑的根本不是 HTTPS、服务端把 TLS 协议全部禁用或只剩一个版本、中间有代理/防火墙/WAF 改写或阻断、客户端版本太老。下面按“先确认事实,再改配置”的顺序展开。
五分钟分层定位:443 端口上到底跑的是什么
不要在不知道现场情况的前提下改 nginx.conf。按下面五步走,每一步都能把问题范围砍掉一半。
第 1 步:谁在监听 443
ss -lntp | grep ':443'
# 或者
lsof -nP -iTCP:443 -sTCP:LISTEN
如果这里什么都没有,问题在监听层:安全组没放行 443、iptables/nftables 丢弃、容器端口没映射、K8s Service 只暴露了 80。此时改 TLS 配置没有任何意义。
第 2 步:443 上跑的是不是明文 HTTP
curl -v --http1.1 http://example.com:443/ 2>&1 | head -20
如果这一步拿到了正常的 HTTP/1.1 200 OK 响应头,说明 443 端口上监听的是 HTTP 服务(常见于 listen 443; 漏写了 ssl、或者 listen 80 被改成了 listen 443、或者 Docker 端口映射写成了 -p 443:80)。这是 ERR_SSL_PROTOCOL_ERROR 最常见的单一原因,浏览器用 https:// 访问必然失败。
第 3 步:完整握手测试
openssl s_client -connect example.com:443 -servername example.com </dev/null
-servername 不能省。不带 SNI 时服务器会返回默认虚拟主机的证书,可能掩盖真实问题(尤其是同 IP 多站点场景)。
第 4 步:分协议版本测试
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | head -20
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null | head -20
读法很直接:
- 1.2 通、1.3 不通 → 服务端 TLS 1.3 未启用,或中间设备不支持 1.3(老版本 F5、老 WAF、老 DPI 设备)。
- 1.3 通、1.2 不通 →
ssl_ciphers里写的是 TLS 1.3 套件名,导致 TLS 1.2 客户端无套件可用,典型报错是sslv3 alert handshake failure。 - 两个都不通 → 回到第 2 步。
第 5 步:绕过 DNS 和 CDN 直连源站
curl -Iv --resolve example.com:443:203.0.113.10 https://example.com/
把 IP 换成源站真实地址。直连正常、走域名报错 → 问题在 CDN / WAF / 四层负载均衡,不在源站,请直接跳到第 6 节。直连也报错 → 问题在源站,继续第 4 节。
真实报错逐条解读
下面这些是你在终端里真正会看到的输出,逐条对照比猜快得多。
1. wrong version number
$ openssl s_client -connect example.com:443 -servername example.com
140234:error:0A00010B:SSL routines::wrong version number:ssl/record/ssl3_record.c:354:
含义:对端返回的第一批字节不是 TLS 记录。九成是明文 HTTP 监听在 443 上,其次是端口转发指向了错误的 backend。
修复:回到第 2 步确认,把 listen 443; 改成 listen 443 ssl;,或把 HTTP 服务挪回 80。
2. unexpected eof while reading
$ curl -Iv https://example.com/
* TLSv1.3 (OUT), TLS handshake, Client hello (1):
curl: (35) OpenSSL/3.0.2: error:0A000126:SSL routines::unexpected eof while reading
含义:握手刚开始,连接就被对端或中间设备关闭。常见原因按概率排序:443 上没有 TLS 服务、防火墙/DPI 主动 reset、证书链文件过大(超过 4KB)触发 MTU 分片问题、源站进程崩溃。
验证:
# 抓包看服务端到底回了什么
sudo tcpdump -i any -n -A 'tcp port 443' | head -60
3. sslv3 alert handshake failure / tlsv1 alert protocol version
$ curl -Iv https://example.com/
curl: (35) OpenSSL/3.0.2: error:0A000410:SSL routines::sslv3 alert handshake failure
含义:服务端明确拒绝了协商结果——协议版本或加密套件没有交集。用 nmap 一次性看清服务端支持什么:
nmap --script ssl-enum-ciphers -p 443 example.com
4. no protocols available
这是客户端本地 openssl 版本太老、不支持你请求的协议版本,不是服务端问题。升级客户端工具即可。
5. unsafe legacy renegotiation disabled
curl: (35) error:0A000152:SSL routines::unsafe legacy renegotiation disabled
含义:对端是 OpenSSL 1.0.x 之前的老服务器。正确做法是升级服务端,不要给客户端加 --legacy-renegotiation 之类的开关。
6. 浏览器侧与语言运行时
- Chrome / Edge:
ERR_SSL_PROTOCOL_ERROR、ERR_SSL_VERSION_OR_CIPHER_MISMATCH - Firefox:
SSL_ERROR_NO_CYPHER_OVERLAP、SSL_ERROR_RX_RECORD_TOO_LONG - Safari:
Safari 无法建立安全连接 - Node.js:
Error: write EPROTO ...:error:0A00010B:SSL routines::wrong version number - Python:
ssl.SSLError: [SSL: WRONG_VERSION_NUMBER] wrong version number - Java:
javax.net.ssl.SSLHandshakeException: The server selected protocol version TLS10 is not accepted by client preferences [TLS12, TLS13](这条是服务端太老,方向相反)
这些都是症状而不是原因,最终都要回到 openssl s_client 的输出。
7. 服务端日志里的对应记录
# nginx error.log(需要 error_log ... info; 级别)
SSL_do_handshake() failed (SSL: error:0A00010B:SSL routines::wrong version number)
while SSL handshaking, client: 1.2.3.4, server: 0.0.0.0:443
# Apache error_log
[ssl:info] [pid 1234] [client 1.2.3.4:5678] AH02008: SSL library error 1 in handshake (server example.com:443)
握手失败发生在 HTTP 层之前,所以 access.log 里通常一条记录都没有——这不是日志坏了,是请求根本没走到那一层。
服务端修复:Nginx 与 Apache 的 443 配置
Nginx 完整 443 server 块
server {
listen 443 ssl;
# nginx 1.25.1 及以上请单独写一行:http2 on;
server_name example.com;
ssl_certificate /etc/nginx/ssl/example.com.fullchain.pem; # 必须含中间证书
ssl_certificate_key /etc/nginx/ssl/example.com.key;
# 关键:不要只留 TLSv1.3
ssl_protocols TLSv1.2 TLSv1.3;
# 只列 TLS 1.2 套件;TLS 1.3 套件由 OpenSSL 内置,写在这里无效
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;
add_header Strict-Transport-Security "max-age=31536000" always;
location / {
proxy_pass http://127.0.0.1:8080;
}
}
# 80 端口只做跳转,不要在这里也配 ssl
server {
listen 80;
server_name example.com;
return 301 https://$host$request_uri;
}
改动后先校验再平滑重载:
nginx -t
nginx -s reload
Nginx 配置阶段的真实报错
nginx: [emerg] no "ssl_certificate" is defined for the "listen ... ssl" directive in /etc/nginx/conf.d/x.conf:12→ 写了ssl但没配证书路径。nginx: [emerg] unknown directive "ssl_certificate"→ 当前二进制没编译with-http_ssl_module,用nginx -V 2>&1 | tr ' ' 'n' | grep ssl确认。nginx: [emerg] "ssl_protocols" directive is not allowed here→ 指令写在了http或location块,只能放在server或http(视版本)块内。
Apache 配置
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# 2.4.27+ 推荐写法
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
apachectl configtest
systemctl reload httpd # Debian/Ubuntu: apache2
Apache 侧常见报错:
AH00526: Syntax error on line 3 of /etc/httpd/conf.d/ssl.conf: Invalid command 'SSLEngine'→ mod_ssl 没启用,用httpd -M | grep ssl_module确认,然后a2enmod ssl或加载模块。AH01914: Configuring server example.com:443 for SSL protocol: SSLCertificateFile: file '/etc/httpd/ssl/example.com.pem' does not exist or is empty→ 路径错或权限不足(SELinux 环境下/etc/httpd/ssl需要正确上下文)。AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate!→ 证书链不完整,缺中间证书,补 fullchain。
TLS 协议版本与加密套件对照表
“要不要保留 TLS 1.2”是这类故障里最常被问的问题。结论:必须保留。只留 1.3 会掉一批真实用户,而且报错方式正是 ERR_SSL_PROTOCOL_ERROR。
| 协议版本 | 标准状态 | 典型支持客户端 | 建议 |
|---|---|---|---|
| TLS 1.0 | 已废弃(RFC 8996) | Windows 7 默认、Android 4.x、JDK 6/7、老 IoT 设备 | 关闭;确有老设备时按来源 IP 单独开一个 server 块 |
| TLS 1.1 | 已废弃(RFC 8996) | 同上 | 关闭 |
| TLS 1.2 | 现行可用 | Windows 7+、Android 5+、JDK 8+、OpenSSL 1.0.1+、几乎所有现役浏览器 | 必须保留 |
| TLS 1.3 | 推荐 | Chrome 70+、Firefox 63+、Safari 12.1+、Android 10+、JDK 11+、OpenSSL 1.1.1+、Windows 10 1809+ | 开启,但不要单独开启 |
只开 TLS 1.3 时会失联的典型群体:Windows 7 / 8.1 上的 IE11 与旧版 Chrome、JDK 8 早期版本、部分 Android 9 及以下设备、支付 SDK 与打印机等嵌入式客户端、云厂商四层负载均衡的健康检查探针。这些客户端报出来的错误和你看到的完全一样。
安全提示:TLS 1.2 配好 ECDHE + AEAD 套件,安全性与 1.3 差距很小。真正该做的是关掉 TLS 1.0/1.1、关掉 CBC 与 RSA 密钥交换,而不是砍掉 1.2。另外,HSTS 头一旦下发就很难回退,确认全站 HTTPS 稳定后再加。
CDN / WAF / 负载均衡:回源协议是最常见的坑
如果第 5 步的直连测试正常、走域名报错,问题几乎一定在中间层。
1. 回源协议与源站实际能力不匹配
CDN 回源配置成 HTTPS,但源站 443 上只有 HTTP,或者源站证书是自签而 CDN 开启了严格校验 → 边缘节点握手失败,用户侧看到 5xx 或 ERR_SSL_PROTOCOL_ERROR。常见厂商错误码:
- Cloudflare
525 SSL handshake failed:回源 TLS 握手失败,多为源站 443 不通或协议不匹配。 - Cloudflare
526 Invalid SSL certificate:回源证书无效。 - 回源模式选
Flexible(回源 HTTP)而源站 80 端口已关闭或强制跳转 HTTPS → 无限重定向或 52x。
2. 健康检查探针用了老协议
四层负载均衡或 K8s Ingress 的健康检查若使用 TLS 1.0/1.1 而源站只开 1.2+,后端会被标记为 unhealthy,用户侧表现为间歇性连接失败。把探针协议改成 TLS 1.2 即可。
3. 中间设备不支持 TLS 1.3
老版本 WAF、DPI 设备、透明代理会直接丢弃含 TLS 1.3 扩展的 ClientHello。定位方法就是第 4 步的分版本握手:1.3 不通、1.2 通,基本可以确定是中间设备。短期可在边缘关闭 1.3,长期应升级设备。
4. 分流验证命令
# 直连源站 IP,绕过 CDN
curl -Iv --resolve example.com:443:203.0.113.10 https://example.com/
# 对比 CDN 边缘 IP
curl -Iv https://example.com/ 2>&1 | grep -E 'Connected to|TLSv|subject:'
两条命令的输出差异,就是中间层做了什么。
故障排查速查表
| 现象 / 报错 | 最可能原因 | 一条命令验证 |
|---|---|---|
wrong version number |
443 上是明文 HTTP | curl -v http://example.com:443/ |
tlsv1 alert protocol version |
服务端禁用了客户端支持的协议 | openssl s_client -tls1_2 ... |
sslv3 alert handshake failure |
套件不匹配(常见于只填了 1.3 套件名) | nmap --script ssl-enum-ciphers -p 443 example.com |
unexpected eof while reading |
握手即断:无 TLS 服务 / 中间设备 / 证书链过大 | openssl s_client -showcerts ... |
| 只有外网访问报错 | CDN/WAF 回源协议错配 | curl -Iv --resolve example.com:443:源站IP https://example.com/ |
| 只有部分用户报错 | 客户端过老,或只开了 TLS 1.3 | 让用户打开 https://www.howsmyssl.com/ 看报告 |
| access.log 里没有记录 | 失败发生在 HTTP 层之前,属正常 | 看 error.log,或 tcpdump -i any -n 'tcp port 443' |
| 间歇性失败 | 多台后端配置不一致 / 健康检查协议不匹配 | 逐个后端 IP 跑 --resolve 测试 |
补充两条定位命令:
# 看证书链是否完整、SNI 是否命中正确站点
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 精简版握手摘要(脚本化巡检很好用)
openssl s_client -connect example.com:443 -servername example.com -brief </dev/null
FAQ
Q1:ERR_SSL_PROTOCOL_ERROR 是证书过期导致的吗?
不是。证书过期报的是 NET::ERR_CERT_DATE_INVALID,说明握手已经走到证书校验阶段。但证书链不完整、SNI 未命中导致返回了错误站点的证书,在个别客户端上会退化成握手失败——所以排查时仍然值得跑一次 -showcerts 确认。
Q2:为什么我的电脑能打开,用户的手机打不开?
最常见是服务端只开了 TLS 1.3,而用户设备(Android 9 及以下、旧版 iOS、企业定制机)只支持到 1.2。其次是客户端所在网络有透明代理或杀毒软件的 HTTPS 扫描模块。让用户访问一个 TLS 检测页拿到客户端能力报告,比反复猜测快得多。
Q3:只开 TLS 1.3 是不是更安全?
不是必要的取舍。TLS 1.2 配好 ECDHE 密钥交换 + AEAD 套件(AES-GCM / ChaCha20-Poly1305)已经足够安全,而砍掉 1.2 换来的是可观的失联用户。正确做法是关掉 1.0/1.1 和弱套件,同时保留 1.2 与 1.3。
Q4:改完 nginx 配置要重启吗?
不需要。nginx -t && nginx -s reload 即可平滑生效,不中断现有连接。但要注意:reload 后旧 worker 会等待存量连接结束,若配置有误,错误只会出现在 error.log 里而 nginx -t 检测不到。
Q5:开了 CDN,源站还需要配证书吗?
取决于回源协议。回源走 HTTPS 就必须配(且 CDN 若开启严格校验,证书必须由公共 CA 签发);回源走 HTTP 则不需要,但源站 80 端口必须真实可用,否则会触发 52x 错误。生产环境推荐全程 HTTPS + 严格校验。
Q6:用在线 SSL 检测工具够吗?
不够。在线工具是从外部单点探测,看不到内网回源链路、健康检查探针、多后端配置差异。必须结合“外部检测 + 直连源站 --resolve 测试 + 服务端 error.log”三方对照。
Q7:443 端口能同时跑 HTTP 和 HTTPS 吗?
标准上不行,浏览器也不会自动降级重试。技术上可以用 nginx stream 模块配合 ssl_preread 做协议分流,但这属于兼容老系统的权宜之计,会显著增加排障复杂度,新部署不建议。
Q8:为什么服务端日志里什么都没有?
因为失败发生在 TLS 握手阶段,HTTP 请求从未被解析。需要把 nginx 的 error_log 级别调到 info(会有性能开销,排查完记得调回),或者直接抓包:sudo tcpdump -i any -n -A 'tcp port 443'。抓包还能立刻看出对端返回的是 TLS 记录还是明文 HTTP,一步定位 wrong version number。
Q9:怎么复现用户遇到的握手失败?
用 curl --tlsv1.2 --tls-max 1.2 -Iv https://example.com/ 或 openssl s_client -tls1_2 强制降版本。如果能复现,服务端配置问题就坐实了;如果只有特定网络环境复现,重点查中间设备。