跳到主要内容

ERR_SSL_PROTOCOL_ERROR 排查实录:TLS 握手失败的 6 大根因与修复命令

ERR_SSL_PROTOCOL_ERROR 是什么:握手在第一层就谈崩了

浏览器报 ERR_SSL_PROTOCOL_ERROR,本质是客户端与服务器在 TLS 握手阶段没能协商出一致的协议版本、密码套件或记录层格式。注意它和证书过期(ERR_CERT_DATE_INVALID)、域名不匹配(ERR_CERT_COMMON_NAME_INVALID)不是一类问题——后者是证书校验失败,前者是“连 TLS 都没谈起来”。

常见触发场景:

  • 443 端口实际由 HTTP 服务监听,客户端发 ClientHello,服务器回了一个 HTTP 响应。
  • 服务器只启用 TLS 1.3,老客户端或老设备只支持 TLS 1.2。
  • 反向代理、防火墙、CDN/WAF 做了 TLS 终止或回源协议错配。
  • 证书链缺失、SNI 未配置、密码套件不重叠。

先记住一个判断原则:能用 openssl s_client 复现的错误,基本不是浏览器问题;只在浏览器出现、命令行正常,优先查代理、QUIC/HTTP3、浏览器策略。

五分钟定位:先跑这 5 条命令

不要先改配置,先拿证据。以下命令在 Linux/macOS 的终端执行,Windows 可用 WSL 或 Git Bash。

# 1. 看 TLS 握手是否成功、协商到哪个协议版本
openssl s_client -connect example.com:443 -servername example.com </dev/null

# 2. 只看协议与加密套件结果(输出更短)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep -E 'Protocol|Cipher'

# 3. 用 curl 复现,-v 会打印握手细节
curl -vI https://example.com --max-time 10

# 4. 看 443 端口到底是谁在监听
sudo ss -lntp | grep ':443'

# 5. 导出 nginx 实际生效配置,确认 443 server 块
sudo nginx -T | grep -n -A20 'listen.*443'

如果第 1 条命令直接报 wrong version number,说明 443 端口上跑的很可能是明文 HTTP;如果报 handshake failure 或 no protocols available,重点查协议版本与密码套件;如果命令行成功而浏览器失败,跳到代理/CDN 章节。

六大根因对照表:症状、证据与修复方向

根因 典型症状/报错 快速验证 修复方向
443 端口跑的是 HTTP wrong version number、ERR_SSL_PROTOCOL_ERROR curl -v http://example.com:443 能返回 200 把 HTTPS server 块绑到 443,或改端口
只启用 TLS 1.3 老客户端失败,新浏览器正常 openssl s_client -tls1_2 报 no protocols available ssl_protocols TLSv1.2 TLSv1.3;
密码套件不重叠 sslv3 alert handshake failure openssl ciphers -v 对比 补 ECDHE/AES-GCM 套件,别只留国密/实验套件
代理/防火墙拦截 命令行正常,浏览器失败;或间歇性失败 换网络、直连源站 IP + Host 放行 443,关闭 TLS inspection
CDN/WAF 回源协议错配 边缘证书正常,回源 502/525 查 CDN 回源端口与协议 回源改 HTTPS 443 或 HTTP 80 对齐
SNI/证书链问题 no suitable key share、证书不匹配 openssl s_client -servername 指定域名 配置 server_name 与完整链

根因一:443 端口上跑的不是 HTTPS

这是最常见也最容易被忽略的原因。nginx 默认站点或某个 server 块写了 listen 443; 却没有 ssl,或者 Docker 端口映射把 443 映射到了容器的 80。客户端发 TLS ClientHello,服务器按 HTTP 解析并回 HTTP/1.1 400 Bad Request,OpenSSL 就会报记录层版本号不对。

# 确认 443 的监听进程
sudo ss -lntp | grep ':443'

# 用明文 HTTP 访问 443,如果能返回 HTTP 响应,基本坐实
curl -v http://example.com:443 --max-time 5

# nginx:确认 443 server 块有 ssl 与证书
server {
    listen 443 ssl;
    http2 on;   # nginx 1.25.1+;旧版本用 listen 443 ssl http2;
    server_name 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;
}

Apache 对应检查:sudo apachectl -S 看 VirtualHost 绑定,确认 <VirtualHost *:443> 内有 SSLEngine on、SSLCertificateFile、SSLCertificateKeyFile。改完执行 sudo nginx -t && sudo systemctl reload nginx 或 sudo apachectl configtest && sudo systemctl reload apache2。

根因二:TLS 协议版本与密码套件配错

“安全加固”文章常让人写 ssl_protocols TLSv1.3;,结果老设备、老 JDK、部分安卓 WebView 直接失联。TLS 1.3 与 1.2 的密码套件配置是分开的:ssl_ciphers 只管 TLS 1.2 及以下,TLS 1.3 用 ssl_conf_command Ciphersuites(OpenSSL 1.1.1+)控制。只留 1.3 时,不支持 1.3 的客户端会收到 protocol version 或 handshake failure。

# 分别用 TLS 1.2 / 1.3 测试,定位是哪个版本失败
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null

# 查看服务端支持的协议与套件(需要 testssl.sh)
./testssl.sh --protocols --ciphers https://example.com

# nginx 推荐配置:兼容与安全兼顾
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:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;

如果业务必须兼容 Windows 7/Android 5 等老客户端,还需保留 TLS 1.2 并确认套件里包含这些客户端支持的 RSA/ECDHE 组合;但不要再回退到 TLS 1.0/1.1。检查 OpenSSL 版本:openssl version -a,低于 1.1.1 的版本不支持 TLS 1.3,别在配置里写 1.3 却跑在老库上。

根因三:代理、防火墙与 CDN/WAF 的干扰

企业网络里的 TLS 中间人(SSL inspection)会把证书替换成公司 CA,部分老旧设备只支持到 TLS 1.2 甚至 1.0,遇到只开 1.3 的站点就直接 ERR_SSL_PROTOCOL_ERROR。另一种情况是 CDN/WAF 边缘证书正常,但回源协议配错:边缘用 HTTPS 回源到源站 80 端口,或者源站只开 443 而回源写 80。

# 绕过本地 DNS/代理,直连源站 IP 并指定 SNI
curl -vI https://example.com --resolve example.com:443:203.0.113.10

# 看代理环境变量是否干扰
env | grep -i proxy

# 检查 CDN 回源:以 Cloudflare 为例,SSL/TLS 模式应为 Full (strict)
# 源站只开 443 时,回源端口必须 443,协议 HTTPS

# 防火墙放行与 TLS 检查
sudo iptables -L -n | grep 443
# 若使用 firewalld
sudo firewall-cmd --list-all

判断方法:同一域名在手机 4G 网络正常、公司 Wi-Fi 失败,基本是网络侧 TLS 检查;curl 加 --resolve 直连源站正常、走 CDN 失败,问题在 CDN 回源或边缘配置。WAF 的“强制 HTTPS”与“最低 TLS 版本”也要对齐,别在边缘设 TLS 1.3、回源却只支持 1.2。

真实报错信息逐条排查

下面这些报错都来自实际环境,看到哪条就按对应方向查。

# 1) 443 端口是 HTTP
140736...:error:0A00010B:SSL routines::wrong version number
curl: (35) error:0A00010B:SSL routines::wrong version number
# 处理:确认 listen 443 ssl; 与端口映射

# 2) 协议版本不匹配
openssl s_client -connect example.com:443 -tls1_2
...:error:0A000102:SSL routines::unsupported protocol
# 处理:ssl_protocols 增加 TLSv1.2

# 3) 密码套件不重叠
sslv3 alert handshake failure
SSL_CTX_set_cipher_list: no cipher match
# 处理:补 ECDHE-RSA-AES128-GCM-SHA256 等通用套件

# 4) nginx 日志中的握手失败
SSL_do_handshake() failed (SSL: error:0A00006C:SSL routines::no suitable key share) while SSL handshaking
# 处理:客户端只发 TLS 1.3 不支持的组,检查 ssl_ecdh_curve;或降级协商到 1.2

# 5) 证书链不完整
curl: (60) SSL certificate problem: unable to get local issuer certificate
# 处理:fullchain.pem 必须包含中间证书

# 6) SNI 未命中
openssl s_client -connect 203.0.113.10:443
# 不返回证书或返回默认站点证书
# 处理:请求时加 -servername example.com,服务端配置 server_name

补充两个高频细节:一是 openssl s_client 不加 -servername 时不会发 SNI,多站点服务器会返回默认证书,看起来像“证书不匹配”,其实要加参数复测;二是 Chrome 对 ERR_SSL_PROTOCOL_ERROR 有时会叠加 QUIC/HTTP3 因素,可在 chrome://flags 临时禁用 QUIC 验证,或用 curl --http1.1 对比。

FAQ:关于 ERR_SSL_PROTOCOL_ERROR 的高频问题

Q1:为什么命令行 openssl 正常,浏览器还是报 ERR_SSL_PROTOCOL_ERROR?
优先查代理、杀毒软件的 HTTPS 扫描、企业 TLS 检查,以及浏览器是否走了 QUIC/HTTP3。用 curl -vI 与浏览器对比,若 curl 正常,问题通常在客户端网络栈或中间设备。

Q2:只开 TLS 1.3 不是更安全吗?
更安全不等于更兼容。面向公众的站点建议 TLSv1.2 TLSv1.3 并存,等确认无老客户端后再考虑收紧。内部系统若客户端可控,可以只开 1.3。

Q3:改了 nginx 配置为什么没生效?
先 sudo nginx -t 再 reload,并确认没有其他 server 块抢占 443,或 default_server 返回了错误证书。用 sudo nginx -T 看合并后的最终配置。

Q4:CDN 场景应该先查哪?
先查边缘证书与最低 TLS 版本,再查回源协议/端口。边缘正常、回源失败时,源站日志里通常能看到 502/525 或握手错误。

Q5:如何快速确认证书链是否完整?
openssl s_client -connect example.com:443 -servername example.com -showcerts,输出里应能看到服务器证书与中间证书;只有一张叶子证书通常意味着链不完整。

Q6:需要升级 OpenSSL 吗?
如果服务端要启用 TLS 1.3,OpenSSL 需 1.1.1 及以上;同时确认 nginx/Apache 编译时链接的是新库,nginx -V 可看编译参数。