// MySQL 错误参考

MySQL 错误 3159:禁止不安全的传输

服务器已启用 require_secure_transport,而客户端未通过 TLS 连接。请使用 TLS 或本地套接字连接。

错误编号
3159
名称
ER_SECURE_TRANSPORT_REQUIRED
SQLSTATE
HY000
类别
连接和客户端
错误信息
Connections using insecure transport are prohibited while --require_secure_transport=ON.

它的意思

开启 require_secure_transport = ON,MySQL 只接受使用 TLS、Unix 套接字或共享内存的连接。普通 TCP 连接在网络层会被接受,但登录时会报 3159 拒绝。许多托管 MySQL 服务默认开启了这个选项。

常见原因

  • 客户端或驱动程序禁用了 TLS(--ssl-mode=DISABLED, useSSL=false).
  • 不协商 TLS 的旧客户端。
  • 通过配置为从不使用 TLS 的工具连接。

如何修复它

  1. 在客户端启用 TLS,例如 mysql --ssl-mode=REQUIRED -h db.example.com -u app -p,或者你驱动的 TLS 选项。

  2. 如果你控制服务器且网络是可信的,可以关闭该要求。

    SET PERSIST require_secure_transport = OFF;

相关错误

更多连接和客户端错误

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

// 错误更少,修复更快

在 SQLly 中使用 MySQL

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