跳到主要内容

ERR_SSL_VERSION_OR_CIPHER_MISMATCH 完全排查指南:协议版本、加密套件与真实报错处置

一、这个错误到底在说什么

TLS 握手的第一步,客户端在 ClientHello 中携带三样关键信息:supported_versions(支持的协议版本,如 TLS 1.2 / 1.3)、cipher_suites(支持的加密套件列表)以及 signature_algorithms(支持的签名算法)。服务端从这些列表里挑出一个双方都支持的组合,通过 ServerHello 回给客户端。只要这三项中有任何一项完全没有交集,握手就会在第一个 RTT 内被直接拒绝:

  • 协议版本无交集:服务端返回 protocol_version 告警(alert 70),或直接断开;
  • 加密套件无交集:服务端返回 handshake_failure(alert 40)或 insufficient_security(alert 71);
  • 签名算法无交集:常见于只提供 SHA-1 签名证书的老服务端遇上 OpenSSL 3 / JDK 17 等新客户端,同样表现为握手失败。

Chrome / Edge 把上述几类告警统一显示为 ERR_SSL_VERSION_OR_CIPHER_MISMATCH;Firefox 则区分得更细:版本不匹配报 SSL_ERROR_UNSUPPORTED_VERSION,套件不匹配报 SSL_ERROR_NO_CYPHER_OVERLAP。

一条关键判断:这个错误几乎从来不是证书问题。证书链缺失、域名不符、证书过期会显示 NET::ERR_CERT_* 系列;而 VERSION_OR_CIPHER 说明 TCP 已经三次握手成功、TLS 已经开始协商,只是算法谈不拢。如果 TCP 都连不上,浏览器会报 ERR_CONNECTION_*。因此排查时不要一上来就换证书,先抓一次握手。

# 抓包只会有 ClientHello + Alert,看不到 Certificate,即可确认是版本/套件阶段失败
tcpdump -i any -w tls.pcap 'tcp port 443'

二、六类成因与 30 秒判断法

成因 典型现象 快速验证
服务端只开 TLS 1.3,客户端太老(Chrome < 70、Android 6、JDK 8) 新版浏览器正常,老设备全部失败 openssl s_client -tls1_2 失败、-tls1_3 成功
服务端只保留 ECDSA 套件,客户端只认 RSA 证书套件 macOS/iOS 正常,Windows 老版本异常 看服务端证书是 RSA 还是 ECDSA,再看 ssl_ciphers 里有没有对应的 ECDHE-RSA
服务端禁用全部 CBC 套件,而老客户端不支持 GCM / CHACHA20 Win7 IE11、Android 4.4、JDK 6/7 报错 用 -cipher 'DEFAULT@SECLEVEL=1:ECDHE-RSA-AES128-SHA' 模拟老客户端
老客户端不发 SNI,落到默认 vhost(默认站点只配了 TLS 1.3 或 ssl_reject_handshake on) 同一个域名,新浏览器正常、老客户端失败;直接 IP 访问也失败 openssl s_client -connect IP:443(不带 -servername)对比结果
中间层(CDN / WAF / LB)终止 TLS,回源与边缘配置不一致 直连源站正常,走域名失败 dig 看解析是否指向 CDN,再对边缘 IP 单独测
客户端自身策略收紧(JDK 8u291+ 禁用 TLS 1.0/1.1、OpenSSL 3 默认 SECLEVEL=2、Windows SChannel 未启用 TLS 1.2) 服务端日志显示客户端主动发 Alert 服务端错误日志里能看到 sslv3 alert handshake failure 由客户端发出

另有一个容易混淆的情况:443 端口上跑的不是 TLS 服务(比如误配成 HTTP、或端口被其他进程占用),报错是 wrong version number 而不是本错误,但表现同样像是连不上,排查时顺手用 curl -v http://host:443 排除一下。

三、5 分钟定位:命令行诊断清单

按下面顺序执行,基本能在 5 分钟内锁定是版本问题还是套件问题。

# 1) 最有用的一条:看最终协商出的协议与套件
echo | openssl s_client -connect example.com:443 -servername example.com -brief 2>&1
# 期望输出:
#   Protocol version: TLSv1.3
#   Ciphersuite: TLS_AES_256_GCM_SHA384

# 2) 逐版本强制探测,定位到底是哪个版本被拒
for v in -tls1 -tls1_1 -tls1_2 -tls1_3; do
  echo "===== $v ====="
  echo | openssl s_client -connect example.com:443 -servername example.com $v 2>&1 
    | grep -E "Protocol|Cipher|alert|error|no protocols"
done

# 3) 模拟老客户端(Win7 / Android 4.4 / JDK 8 的弱套件视角)
echo | openssl s_client -connect example.com:443 -servername example.com -tls1_2 
  -cipher 'DEFAULT@SECLEVEL=1:ECDHE-RSA-AES128-SHA:AES128-SHA:DES-CBC3-SHA' 2>&1 | head -20

# 4) 枚举服务端完整套件矩阵
nmap --script ssl-enum-ciphers -p 443 example.com

# 5) testssl.sh:协议、套件、评级一次跑完
docker run --rm -it drwetter/testssl.sh --protocols --ciphers --server-defaults https://example.com

# 6) SSL Labs API,无需打开浏览器
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done" 
  | python3 -c "import sys,json;d=json.load(sys.stdin);print([(e['ipAddress'],e.get('grade')) for e in d['endpoints']])"

# 7) 确认本机 OpenSSL 到底支持什么
openssl version -a
openssl ciphers -v 'ECDHE+AESGCM' | head

判读要点:no protocols available 是本地 OpenSSL 不支持该版本(例如 OpenSSL 3 默认已编译进去但被策略禁掉);alert protocol version 是服务端拒绝该版本;sslv3 alert handshake failure 是双方版本能对上但套件谈不拢。

四、服务端修复:Nginx / Apache / Tomcat / Node.js / IIS / HAProxy

Nginx

server {
    listen 443 ssl http2;
    server_name example.com;

    # 最低底线 TLS 1.2,推荐同时开 1.3
    ssl_protocols TLSv1.2 TLSv1.3;

    # 注意:ssl_ciphers 只作用于 TLS 1.2 及以下
    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;

    # TLS 1.3 套件需要用 ssl_conf_command(nginx >= 1.19.4 + OpenSSL 1.1.1+)
    ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;

    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;
    ssl_dhparam /etc/nginx/dhparam.pem;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}

三个高频问题:

  • ssl_ciphers 里写 TLS_AES_128_GCM_SHA256 会导致 nginx -t 直接报 SSL_CTX_set_cipher_list() failed ... no cipher match,因为该参数只解析 TLS 1.2 及以下的套件名。
  • 改完必须 nginx -t && nginx -s reload,只 reload 不 test 会在线上留一个坏配置。
  • 如果前面有 CDN / SLB,改源站配置对浏览器无效,必须改边缘节点的 TLS 策略。

Apache httpd

SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
SSLSessionTickets off
SSLOpenSSLConfCmd Curves X25519:prime256v1:secp384r1

Tomcat(server.xml)

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true"
           sslEnabledProtocols="TLSv1.2,TLSv1.3"
           ciphers="TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256" />

Tomcat 8.5 以下需要显式配置 sslProtocol="TLSv1.2",并且确认 JSSE 实现(不是 APCrypt)才能启用 TLS 1.3。

Node.js

const https = require('https');
https.createServer({
  key, cert,
  minVersion: 'TLSv1.2',
  maxVersion: 'TLSv1.3',
  ciphers: [
    'TLS_AES_128_GCM_SHA256',
    'TLS_AES_256_GCM_SHA384',
    'TLS_CHACHA20_POLY1305_SHA256',
    'ECDHE-RSA-AES128-GCM-SHA256',
    'ECDHE-RSA-AES256-GCM-SHA384'
  ].join(':')
}, app).listen(443);

IIS / Windows SChannel(PowerShell)

# 显式启用 TLS 1.2(客户端与服务端两侧都要)
$base = 'HKLM:SYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocolsTLS 1.2'
New-Item -Path "$baseClient" -Force | Out-Null
New-ItemProperty -Path "$baseClient" -Name 'Enabled' -Value 1 -PropertyType DWORD -Force
New-ItemProperty -Path "$baseClient" -Name 'DisabledByDefault' -Value 0 -PropertyType DWORD -Force
New-Item -Path "$baseServer" -Force | Out-Null
New-ItemProperty -Path "$baseServer" -Name 'Enabled' -Value 1 -PropertyType DWORD -Force
New-ItemProperty -Path "$baseServer" -Name 'DisabledByDefault' -Value 0 -PropertyType DWORD -Force
# 修改后必须重启(或重启 HTTP 服务)

生产环境建议直接用 IISCrypto 工具勾选,避免手写注册表漏项。

HAProxy

global
  ssl-default-bind-ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305
  ssl-default-bind-ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256
  ssl-default-bind-options ssl-min-ver TLSv1.2 no-tls-tickets

五、客户端与运行时修复

很多「服务端看起来没问题但业务就是报错」的场景,根因在调用方运行时太老或被策略锁死。

  • 浏览器:升级到最新版即可;Firefox 可临时用 about:config 里的 security.tls.version.min 调到 3(TLS 1.2)验证,但不要长期停留在低值。
  • JDK 8:8u291 起 jdk.tls.disabledAlgorithms 默认已加入 TLSv1、TLSv1.1。若必须连老服务端,启动参数加 -Djdk.tls.client.protocols=TLSv1.2 定位问题;确认服务端确实只支持 TLS 1.0 时,改 $JAVA_HOME/jre/lib/security/java.security 是最后手段(会拉低全局安全性)。
  • OpenSSL 3 / RHEL 9 / Ubuntu 22.04:默认 SECLEVEL=2,会拒绝 SHA-1 签名、1024 位 RSA、小于 2048 位 DH。临时放宽:在 /etc/ssl/openssl.cnf 的 [system_default_sect] 中设 CipherString = DEFAULT@SECLEVEL=1,仅用于内网排障。
  • Python requests:session.mount('https://', HTTPAdapter()) 之外,用 ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT) + ctx.minimum_version = ssl.TLSVersion.TLSv1_2,必要时 ctx.set_ciphers('DEFAULT@SECLEVEL=1')。
  • Node.js:tls.connect({ host, port, minVersion: 'TLSv1.2' });老代码可临时 NODE_OPTIONS=--tls-min-v1.0。
  • .NET Framework:ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;,默认值在 4.5/4.6 上可能仍是 SSL3/TLS1.0。
  • curl:curl --tlsv1.2 --tls-max 1.2 -vI https://example.com 用于验证特定版本。
  • Android 4.x:系统 SSLSocket 默认不启用 TLS 1.2,需接入 Google Play Services 的 ProviderInstaller.installIfNeeded() 或升级 OkHttp 并显式指定 ConnectionSpec。

六、协议与套件兼容性对照表

协议版本

协议 发布年份 Chrome / Edge Firefox Safari JDK 默认 建议
SSLv3 1996 已移除 已移除 已移除 已禁用 必须关闭(POODLE)
TLS 1.0 1999 Chrome 84 起移除 Firefox 74 起移除 已移除 8u291 起禁用 关闭(PCI DSS 不允许)
TLS 1.1 2006 Chrome 84 起移除 Firefox 74 起移除 已移除 8u291 起禁用 关闭
TLS 1.2 2008 支持 支持 支持 JDK 8+ 支持 最低底线
TLS 1.3 2018 Chrome 70+ Firefox 63+ Safari 12.1+ JDK 11+ 推荐开启

加密套件

套件 协议 典型客户端 建议
TLS_AES_128_GCM_SHA256 TLS 1.3 现代浏览器全支持 默认开启
TLS_CHACHA20_POLY1305_SHA256 TLS 1.3 移动端性能更好 默认开启
ECDHE-RSA-AES128-GCM-SHA256 TLS 1.2 2013 年后的绝大多数客户端 保留
ECDHE-RSA-CHACHA20-POLY1305 TLS 1.2 Android 5+ / 中低端设备 保留
ECDHE-RSA-AES128-SHA(CBC) TLS 1.2 Win7 IE11、Android 4.4 仅在兼容 vhost 中开启
AES128-SHA(RSA 密钥交换,无 PFS) TLS 1.2 极老客户端 尽量避免
DES-CBC3-SHA(3DES) TLS 1.2 XP / JDK 6 禁用(Sweet32)
RC4-SHA TLS 1.2 极老客户端 禁用(RFC 7465)

决策原则:主站配置以 A 级为目标(TLS 1.2 + 1.3,仅 AEAD 套件);确实存在的老旧内网终端,用独立端口 / 独立 vhost + IP 白名单承载弱套件,主站不受影响。

七、真实报错信息排查手册

来源 原始报错 含义 处置
Chrome / Edge ERR_SSL_VERSION_OR_CIPHER_MISMATCH 版本或套件无交集,或服务端在握手中主动断开 按第三节逐版本探测;检查是否有 ssl_reject_handshake on 或默认 vhost 配置错误
Firefox SSL_ERROR_NO_CYPHER_OVERLAP 版本 OK,套件无交集 扩充服务端 ssl_ciphers,或升级客户端
Firefox SSL_ERROR_UNSUPPORTED_VERSION 协议版本无交集 服务端补开 TLS 1.2,或客户端升级
OpenSSL 客户端 error:0A000410:SSL routines::sslv3 alert handshake failure 服务端拒绝客户端提供的套件 用 -cipher 逐个试,找出服务端实际允许的套件
OpenSSL 客户端 tlsv1 alert protocol version 服务端不支持该协议版本 服务端调整 ssl_protocols
OpenSSL 客户端 no protocols available 本地 OpenSSL 不支持或已禁用该版本 检查本地 openssl.cnf 的 MinProtocol,不是服务端问题
OpenSSL 3 客户端 no suitable signature algorithm / tlsv1 alert insufficient security 服务端证书或密钥参数低于 SECLEVEL=2 要求 换 SHA-256 证书,或临时 DEFAULT@SECLEVEL=1
curl curl: (35) error:0A000410:SSL routines::sslv3 alert handshake failure 同 OpenSSL,套件不匹配 curl --tlsv1.2 --tls-max 1.2 -v 逐步定位
Java 客户端 javax.net.ssl.SSLHandshakeException: Received fatal alert: protocol_version 服务端不接受客户端支持的最高版本 服务端补开 TLS 1.2;客户端加 -Djdk.tls.client.protocols=TLSv1.2
Java 客户端 The server selected protocol version TLS10 is not accepted by client preferences [TLS13, TLS12] 服务端只给 TLS 1.0,客户端(8u291+)已禁用 升级服务端,不要回退客户端策略
Python requests requests.exceptions.SSLError: ... [SSL: SSLV3_ALERT_HANDSHAKE_FAILURE] 与 curl 同理 设置 ctx.minimum_version 与 set_ciphers
Node.js Error: write EPROTO 1408F10B:SSL routines:ssl3_get_record:wrong version number 用 HTTPS 打了 HTTP 端口(或反之) 检查端口与 https:// 前缀,不是套件问题
.NET The request was aborted: Could not create SSL/TLS secure channel. Framework 默认协议过老 ServicePointManager.SecurityProtocol = Tls12
Nginx 错误日志 SSL_do_handshake() failed (SSL: error:0A000410:SSL routines::sslv3 alert handshake failure) while SSL handshaking, client: 203.0.113.7 客户端(或中间层)主动发 Alert 看 client IP 判断是终端还是上游 LB,再决定改哪一侧
Nginx 错误日志 SSL_do_handshake() failed (SSL: ... no shared cipher) 服务端套件列表与客户端零交集 补 CBC 套件或升级客户端
Windows / SChannel 「客户端和服务器无法通信,因为它们不具有共同的算法」(WinHTTP 12175) SChannel 未启用 TLS 1.2 按第四节注册表脚本启用并重启

八、达到 SSL Labs A 级的推荐配置与验证

直接使用 Mozilla SSL Configuration Generator(ssl-config.mozilla.org)选择「Intermediate」档位,比手工拼套件列表更稳。A 级检查清单:

  • 只启用 TLS 1.2 与 TLS 1.3,关闭 SSLv3 / TLS 1.0 / TLS 1.1;
  • 禁用 RC4、3DES、EXPORT、NULL、匿名套件;
  • 优先 AEAD(GCM / CHACHA20),CBC 套件仅在有明确兼容需求时保留;
  • 开启 HSTS(先短 max-age 灰度,再拉长);
  • 配置 OCSP Stapling,关闭 Session Tickets 或定期轮换 ticket key;
  • DH 参数 ≥ 2048 位(openssl dhparam -out /etc/nginx/dhparam.pem 2048);
  • 证书链完整(含中间证书),签名算法 SHA-256 及以上。
# 生成 DH 参数
openssl dhparam -out /etc/nginx/dhparam.pem 2048

# 验证:老协议必须失败
openssl s_client -connect example.com:443 -servername example.com -tls1_1 2>&1 | grep -E "alert|Protocol"

# 验证:TLS 1.2 与 1.3 必须都成功
for v in -tls1_2 -tls1_3; do echo | openssl s_client -connect example.com:443 -servername example.com $v -brief 2>&1 | head -3; done

# 复测评级
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done" 
  | python3 -c "import sys,json;d=json.load(sys.stdin);print([(e['ipAddress'],e.get('grade'),e.get('statusMessage')) for e in d['endpoints']])"

如果业务方坚持要保留 TLS 1.0 给某个老旧内网系统,正确做法是拆出一个只监听内网网卡、只对白名单 IP 开放的 server 块,主站配置保持 A 级——而不是把主站的 ssl_protocols 整体降级。

九、FAQ

Q1:升级到只开 TLS 1.3 后,老客户端全部报错,怎么办?
把 ssl_protocols 改为 TLSv1.2 TLSv1.3。TLS 1.3 的收益主要在握手延迟与安全性,但仅开 1.3 会直接抛弃 JDK 8、Android 6 及更早的终端,实际收益远小于兼容性损失。

Q2:为什么在 ssl_ciphers 里写了 TLS 1.3 套件不生效,甚至 nginx -t 报错?
ssl_ciphers 只解析 TLS 1.2 及以下的套件名。TLS 1.3 套件要用 ssl_conf_command Ciphersuites ...(nginx ≥ 1.19.4 + OpenSSL 1.1.1+),而且 TLS 1.3 只有 5 个标准套件,删减空间很小。

Q3:ERR_SSL_VERSION_OR_CIPHER_MISMATCH 和 ERR_SSL_PROTOCOL_ERROR 有什么区别?
前者是「TCP 通了、TLS 谈了、但算法没谈拢」;后者通常是「TLS 记录层就解析失败」,多见于 443 端口跑的不是 TLS 服务、或中间设备改写了流量。前者查配置,后者查端口与链路。

Q4:会不会是证书问题?
不会直接是。证书问题的报错前缀是 NET::ERR_CERT_*。但有一种间接情况:老客户端不发 SNI,落到默认 vhost,而该 vhost 只配置了 TLS 1.3 或 ssl_reject_handshake on,表现就是本错误——此时要查的是 vhost 匹配,不是证书本身。

Q5:只保留 TLS 1.2/1.3 会不会影响搜索引擎收录?
Googlebot 早已支持 TLS 1.2 及以上,主流搜索引擎的抓取端均无问题。真正需要评估的是企业内网终端、老旧 SDK 和第三方回调方。

Q6:内网系统必须支持 JDK 6 / Win7 IE11,怎么兼顾安全评级?
拆分配置:主站保持 A 级;为老系统单独开一个端口或独立 vhost,只放行必要的 CBC 套件并加 IP 白名单,同时在网关层记录访问量,推动业务方排期升级。不要让主站为少数客户端降级。

Q7:修改配置后如何确认真的修好了?
三步验证:① openssl s_client -brief 能看到预期协议与套件;② 用之前报错的那个客户端/运行时实际跑一次业务请求;③ SSL Labs 或 testssl.sh 复测评级,确认没有引入新的弱项。

Q8:为什么本地 curl 正常,线上容器里就报错?
大概率是运行时版本差异:容器内是 OpenSSL 3 / 精简镜像(如 alpine 的 libressl 或缺失 CA),默认 SECLEVEL 与套件集和宿主机不同。用 openssl version -a 在容器内对比一次即可确认。