// MySQL 错误参考

MySQL 错误 2003:无法连接到主机上的 MySQL 服务器

客户端无法打开到主机和端口的 TCP 连接。服务器可能已停止、在其他地方监听,或者防火墙阻拦了连接。

错误编号
2003
名称
CR_CONN_HOST_ERROR
类别
连接和客户端
错误信息
Can't connect to MySQL server on '%s:%u' (%d)

它的意思

当 TCP 连接本身失败时,客户端会引发 2003 错误。方括号中的数字是操作系统错误: (111) 或者 (10061) 在 Windows 上表示连接被拒绝(没有服务在监听), (110) 或者 (10060) 表示超时(通常是防火墙丢包),而 (113) 表示没有通往主机的路由。

服务器根本没收到这次登录尝试,所以密码和授权暂时都无关紧要。

常见原因

  • 服务器没有运行,或监听的不是 3306 端口。
  • 服务器仅监听 127.0.0.1 (bind_address),因此会拒绝远程连接。
  • 防火墙、安全组或云网络规则挡住了 3306 端口。
  • 连接设置中主机名或 IP 地址错误。

如何修复它

  1. 在服务器上,检查 MySQL 是否运行以及监听的地址和端口。

    SHOW VARIABLES WHERE Variable_name IN ('bind_address', 'port', 'skip_networking');
  2. 要接受远程连接,请设置 bind_address = 0.0.0.0 (或服务器自身的 IP)在 [mysqld] 编辑配置文件的相应部分并重启 MySQL。确保远程主机有对应的账户。

  3. 在服务器防火墙以及任意云安全组中开放端口,然后从客户端机器进行测试,例如使用 nc -vz db.example.com 3306.

相关错误

更多连接和客户端错误

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

// 错误更少,修复更快

在 SQLly 中使用 MySQL

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