// MySQL 错误参考
MySQL 错误 2026:SSL 连接错误
客户端与 MySQL 服务器之间的 TLS 握手失败:客户端不信任的证书、TLS 版本不匹配,或要求 SSL 却未启用。
- 错误编号
2026- 名称
CR_SSL_CONNECTION_ERROR- 类别
- 连接和客户端
它的意思
客户端和服务器无法建立加密连接。之后的文本 SSL connection error: 是 TLS 库给出的原因,例如证书验证失败、没有共同支持的协议版本,这才是该看的部分。
常见原因
- 客户端验证服务器证书(
--ssl-mode=VERIFY_CA或者VERIFY_IDENTITY),但证书是自签名的或主机名不匹配。 - 客户端要求使用 TLS,而服务器禁用了 TLS。
- 旧客户端或服务器仅支持另一方已关闭的 TLS 版本。
- CA、证书或密钥文件的路径或权限错误。
如何修复它
-
检查服务器提供的内容。
SHOW VARIABLES LIKE '%ssl%'; SHOW VARIABLES LIKE 'tls_version';
-
把签发服务器证书的 CA 证书交给客户端,例如
mysql --ssl-mode=VERIFY_CA --ssl-ca=ca.pem -h db.example.com -u app -p. -
如果双方都很旧,应升级客户端库,而不是在服务器上重新启用旧的 TLS 版本。
相关错误
更多连接和客户端错误
2002无法通过套接字连接2003无法连接到主机上的 MySQL 服务器2005未知 MySQL 服务器主机2006MySQL 服务器已断开连接2013查询过程中与 MySQL 服务器的连接丢失2061身份验证插件报告错误1251客户端不支持认证协议1158读取通信数据包时出错
代码和消息文本来自 MySQL 8.4 错误信息参考。浏览完整的 MySQL 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 MySQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 MySQL 以及你使用的其他数据库。