MySQL 8.0+ 连接失败主因是TLS协议与认证插件双重不兼容:服务端默认仅支持TLSv1.2+且认证插件为caching_sha2_password,而旧驱动(如5.1.x)既不支持TLSv1.2握手,也无法识别新认证插件,导致握手或认证阶段直接失败。

MySQL 8.0+ 默认强制 TLS 1.2,老驱动不支持
MySQL 5.7.6+(尤其 8.0+)默认启用 require_secure_transport=ON,且服务端只加载 TLS 1.2 或更高版本的协议。而 mysql-connector-java-5.1.x 等老驱动在握手时只尝试 TLSv1.0/TLSv1.1,服务器直接返回 javax.net.ssl.SSLException: Received fatal alert: protocol_version 并断连。
这不是“连接被拒绝”,而是 TLS 握手阶段就失败——客户端发不出兼容的 ClientHello,服务端连证书都不发。
- Java 7 及更早版本默认不支持 TLS 1.2,即使换新驱动也无济于事
- Java 8u131 之前版本默认禁用 TLS 1.2,需手动加 JVM 参数:
-Dhttps.protocols=TLSv1.2 - mysql-connector-java-5.1.49 是最后一个 5.x 版本,但它仍无法协商 TLS 1.2(除非显式配置
enabledTLSProtocols=TLSv1.2,但该参数在 5.x 中不可靠)
旧驱动默认用 mysql_native_password,而 MySQL 8.0 默认用 caching_sha2_password
即使绕过 SSL 协议问题(比如加 useSSL=false),老驱动仍会在认证阶段卡住。因为 MySQL 8.0 创建用户时默认使用 caching_sha2_password 插件,而 5.x 驱动根本不识别该插件,报错类似:Authentication plugin 'caching_sha2_password' cannot be loaded。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 这个错误和 SSL 无关,但常被误判为 SSL 问题——实际是认证流程在 SSL 握手之后、SQL 交互之前就中断了
-
com.mysql.jdbc.Driver类在 8.x 驱动中已彻底移除,硬编码该类名会直接抛ClassNotFoundException,不是“连不上”,是根本起不来 - 降级认证插件(
ALTER USER 'user'@'host' IDENTIFIED WITH mysql_native_password BY 'pwd';)只是临时 workaround,不符合安全规范
连接串里缺关键参数,驱动行为与预期严重偏离
mysql-connector-java-8.x 驱动在开启 SSL 的前提下,对连接参数极其敏感。老项目沿用 5.x 的连接串(比如没带 serverTimezone、allowPublicKeyRetrieval=true),会导致看似连接成功,实则后续操作异常:
-
serverTimezone缺失 → 第一次查询可能 hang 住或返回空结果,日志里只有模糊的SQLNonTransientConnectionException -
allowPublicKeyRetrieval=true缺失(MySQL 8.0.4+ 引入)→ RSA 密钥交换失败,连接卡在 handshake 后半段,错误可能是Unable to retrieve public key -
characterEncoding=utf8缺失 → 某些中文字段插入时触发Incorrect string value,尤其当表用utf8mb4但驱动未声明编码时
CA 证书路径/权限/内容三重校验失败,静默降级成非 SSL 连接
MySQL 服务端加载 CA 证书失败时,SHOW STATUS LIKE 'Ssl_cipher'; 返回空,have_ssl 显示 DISABLED,但错误日志往往只写一句 Could not set ssl_mode。客户端如果配了 sslMode=VERIFY_CA 却没指定 sslTrustCertificate,就会在 TLS 握手末期报 SSLHandshakeException: PKIX path building failed。
-
ssl_ca必须写在[mysqld]段,且路径必须绝对;~/ca.pem或./ca.pem全部无效 - 文件权限必须是
600,属主必须是mysql用户;644会导致服务启动时静默跳过证书加载 - 云数据库(RDS/Aliyun)提供的 CA 证书不能用本地
mysql_ssl_rsa_setup生成的证书替代;必须下载控制台明确提供的RDS-Global-Bundle.pem类文件


















