Firefox SSL_ERROR_RX_RECORD_TOO_LONG 完全排查指南:443 明文、反代错配与修复命令
一、错误含义:TLS 记录头被误读为“超长记录”
Firefox 报 SSL_ERROR_RX_RECORD_TOO_LONG,意思是它在 TLS 握手读取服务器第一条记录时,解析出的记录长度超过了协议上限(TLS 记录负载最大 2^14 字节,加上额外开销也不超过 18432 字节)。
TLS 记录头固定 5 字节:1 字节内容类型、2 字节协议版本、2 字节长度。如果 443 端口返回的其实是明文 HTTP 响应,Firefox 会把 HTTP/1.1 400 Bad Request 的首字节 H(0x48)当成记录类型,把后面的字节当成版本和长度。解析出的长度一旦越界,就得到这个错误;如果版本字段不合法,则报 SSL_ERROR_RX_WRONG_VERSION_NUMBER。两者是同一类问题的不同表现。
一句话结论:客户端在说 TLS,服务器却在回明文。
二、头号原因:443 端口上跑的是 HTTP
最常见的三种写法错误:
- Nginx 写了
listen 443;,漏了ssl参数,证书配置形同虚设。 - Apache 的
<VirtualHost *:443>里没有SSLEngine on,或证书指令写在错误的 VirtualHost。 - Node.js / Go / Python 应用直接以
http监听 443,前面又没有 TLS 终止层。
其次是链路错配:负载均衡或 CDN 以 TCP/明文方式回源到只接受 TLS 的 443,或者反过来,把 TLS 流量转发到明文后端端口。
三、5 分钟定位:按顺序执行命令
# 1. 确认谁在监听 443
sudo ss -lntp | grep ':443'
# 2. 用明文 HTTP 访问 443:有 HTTP 响应 = 该端口没跑 TLS
curl -I --max-time 5 http://example.com:443
# 3. 用 TLS 访问,记录真实报错
curl -vkI --max-time 5 https://example.com
# 4. 直接观察 TLS 握手
openssl s_client -connect example.com:443 -servername example.com </dev/null
# 5. 绕过 CDN/LB,直连源站回环
openssl s_client -connect 127.0.0.1:443 -servername example.com </dev/null | head -5
判读方法:第 2 步如果返回 HTTP/1.1 200、301、400 等任何 HTTP 状态行,基本可以确诊——443 端口说的是 HTTP。第 4 步如果输出 wrong version number 或直接打印出 HTML,也指向同一结论。
四、按场景修复
Nginx
server {
listen 443 ssl;
# Nginx 1.25.1+ 用 http2 on; 旧版本写 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;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
server {
listen 80;
server_name example.com;
return 301 https://$host$request_uri;
}
nginx -t && nginx -s reload
nginx -T | grep -nE 'listen.*443|ssl_certificate'
注意:proxy_pass 的目标协议必须和后端实际协议一致。后端是明文就写 http://backend:8080,不要写成 http://backend:443 或 https:// 混用。
Apache
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
ProxyPass / http://127.0.0.1:8080/
ProxyPassReverse / http://127.0.0.1:8080/
</VirtualHost>
apachectl configtest && systemctl reload apache2
反向代理与负载均衡
- 四层(TCP)监听 443 时,后端必须也是 TLS;若后端是明文,应改成七层 HTTPS 终止,或把后端端口改为明文端口。
- 七层 HTTPS 监听回源时,把 Origin Protocol 从 HTTP 改为 HTTPS,并确认回源端口为 443。
- 开启 SNI:Nginx 加
proxy_ssl_server_name on;,否则多证书后端可能返回默认站点证书。
CDN
Cloudflare 等平台出现 525 SSL handshake failed,通常就是“边缘用 HTTPS 回源、源站 443 却是明文”。把回源协议改为 HTTP(若源站只提供 HTTP),或在源站正确启用 TLS。
五、配置对比表:症状、根因与修复
| 症状 | 根因 | 修复 |
|---|---|---|
curl http://域名:443 返回 HTTP 状态行 |
443 监听未启用 TLS | Nginx 加 ssl;Apache 加 SSLEngine on |
浏览器报错,但 curl -k https:// 正常 |
证书链不完整或域名不匹配 | 补全 fullchain,检查 SNI 与 SAN |
Nginx 日志 wrong version number while SSL handshaking |
反代把明文流量发到了 TLS 后端 | 统一 proxy_pass 协议与后端端口 |
| 只有 IPv6 访问失败 | AAAA 记录指向了未配置 TLS 的机器 | 修正 AAAA 或在该机启用 443 TLS |
| CDN 报 525/526 | 回源协议与源站不匹配 | 调整 Origin Protocol 或源站证书 |
本机 openssl s_client 正常,公网异常 |
中间 LB/WAF 做了 TLS 终止或协议改写 | 检查 LB 监听器与后端组协议 |
六、真实报错信息对照与排查
- Firefox:
SSL_ERROR_RX_RECORD_TOO_LONG/SSL_ERROR_RX_WRONG_VERSION_NUMBER—— 收到非 TLS 数据。 - curl:
curl: (35) error:0A00010B:SSL routines::wrong version number—— 与 Firefox 同源,OpenSSL 的说法。 - openssl:
error:0A00010B:SSL routines::wrong version number,或握手后直接输出HTTP/1.1 400 Bad Request。 - Nginx error.log:
SSL_do_handshake() failed (SSL: error:0A00010B:SSL routines::wrong version number) while SSL handshaking—— 客户端用 TLS 连到了明文 server 块。 - Apache error.log:
[ssl:error] [pid ...] AH02042: ...伴随Invalid method in request—— 明文请求打到了 SSL 虚拟主机。 - Cloudflare:
Error 525: SSL handshake failed—— 边缘到源站 TLS 握手失败。
排查顺序建议:先 ss -lntp 确认进程,再 curl http://:443 判断协议,最后用 openssl s_client 验证证书与 SNI。三步之内基本能定位到具体 server 块或后端组。
七、修复后的验证清单
# 证书与握手
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -dates
# 强制 TLS 版本与 SNI 测试
curl -vI --tlsv1.2 --resolve example.com:443:203.0.113.10 https://example.com
# 确认 80 端口正确跳转
curl -I http://example.com
# 端口扫描确认 443 只跑 TLS
nmap --script ssl-enum-ciphers -p 443 example.com
预期结果:openssl 输出证书主题与有效期;curl -I https:// 返回 HTTP/2 200 或 HTTP/1.1 200;curl -I http:// 返回 301 且 Location 指向 https。
八、FAQ
Q1:为什么只有 Firefox 报错,Chrome 却正常?
不同浏览器对畸形记录头的容错策略不同。Chrome 可能显示 ERR_SSL_PROTOCOL_ERROR 或直接降级提示,本质相同。不要以“Chrome 能打开”作为 TLS 正常的依据,用 openssl s_client 验证。
Q2:清缓存、换 DNS 有用吗?
基本没用。这是协议层错误,不是缓存或解析问题。除非你刚切换了 CDN 或 IP,才需要排除 DNS 缓存。
Q3:证书刚续期就出现这个错误,是证书问题吗?
证书问题通常报 SSL_ERROR_BAD_CERT_DOMAIN 或 SEC_ERROR_EXPIRED_CERTIFICATE。本错误指向协议/端口错配,优先检查监听配置是否被改动。
Q4:Nginx 配置看起来没问题,为什么还报错?
检查是否有多个 server 块监听 443,默认 server 抢占了 SNI;用 nginx -T 输出完整配置,确认 server_name 与证书匹配。也可能是上层 LB 已做 TLS 终止,却仍以 HTTPS 回源。
Q5:可以用 HTTP/2 或 HTTP/3 绕过吗?
不能。HTTP/2 与 HTTP/3 都建立在 TLS 之上,底层协议错配依旧失败。先修复 443 的 TLS 监听。
Q6:如何快速判断是源站问题还是 CDN 问题?
用 curl --resolve 直连源站 IP,或在内网执行 openssl s_client -connect 127.0.0.1:443。直连正常而公网异常,问题在 CDN/LB;直连也异常,问题在源站配置。
Q7:修复后需要重启整个服务器吗?
不需要。Nginx 用 nginx -t && nginx -s reload 平滑重载;Apache 用 apachectl configtest && systemctl reload apache2。只有更换监听端口或底层网络配置时才考虑重启服务。