跳到主要内容

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。只有更换监听端口或底层网络配置时才考虑重启服务。