// MySQL 错误参考

MySQL 错误 2026:SSL 连接错误

客户端与 MySQL 服务器之间的 TLS 握手失败:客户端不信任的证书、TLS 版本不匹配,或要求 SSL 却未启用。

错误编号
2026
名称
CR_SSL_CONNECTION_ERROR
类别
连接和客户端
错误信息
SSL connection error: %s

它的意思

客户端和服务器无法建立加密连接。之后的文本 SSL connection error: 是 TLS 库给出的原因,例如证书验证失败、没有共同支持的协议版本,这才是该看的部分。

常见原因

  • 客户端验证服务器证书(--ssl-mode=VERIFY_CA 或者 VERIFY_IDENTITY),但证书是自签名的或主机名不匹配。
  • 客户端要求使用 TLS,而服务器禁用了 TLS。
  • 旧客户端或服务器仅支持另一方已关闭的 TLS 版本。
  • CA、证书或密钥文件的路径或权限错误。

如何修复它

  1. 检查服务器提供的内容。

    SHOW VARIABLES LIKE '%ssl%';
    SHOW VARIABLES LIKE 'tls_version';
  2. 把签发服务器证书的 CA 证书交给客户端,例如 mysql --ssl-mode=VERIFY_CA --ssl-ca=ca.pem -h db.example.com -u app -p.

  3. 如果双方都很旧,应升级客户端库,而不是在服务器上重新启用旧的 TLS 版本。

相关错误

更多连接和客户端错误

代码和消息文本来自 MySQL 8.4 错误信息参考。浏览完整的 MySQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 MySQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 MySQL 以及你使用的其他数据库。