// MySQL 错误参考

MySQL 错误 2002:无法通过套接字连接

客户端尝试了本地 Unix 套接字,但那里没有服务器。服务器没在运行、用了别的套接字路径,或者你其实想连的是 TCP。

错误编号
2002
名称
CR_CONNECTION_ERROR
类别
连接和客户端
错误信息
Can't connect to local MySQL server through socket '%s' (%d)

它的意思

当你连接到 localhost 在 Unix 上,MySQL 客户端使用 Unix 套接字文件而不是 TCP。2002 表示套接字文件不存在或没有任何服务在其上监听。方括号中的数字是操作系统错误,例如 (2) 表示没有此类文件,以及 (111) 表示连接被拒绝。

这是客户端错误:请求从未到达服务器。

常见原因

  • MySQL 服务器未运行,或者启动时崩溃。
  • 服务器的套接字位置与客户端预期的位置不同(例如 /var/run/mysqld/mysqld.sock 与 /tmp/mysql.sock).
  • 服务器运行在 Docker 中或另一台机器上,因此没有本地套接字;你需要使用 TCP。
  • 套接字目录上的权限阻止客户端访问它。

如何修复它

  1. 检查服务器是否正在运行,如果没有,请读取其错误日志,例如使用 systemctl status mysql 在 Linux 上或者 brew services list 在 macOS 上。

  2. 改用 TCP 而非套接字连接,使用 127.0.0.1 而不是 localhost,或 --protocol=TCP.

    mysql -h 127.0.0.1 -P 3306 -u app -p
  3. 如果服务器在本地运行,找到它的套接字路径并让客户端指向它。

    -- On the server:
    SHOW VARIABLES LIKE 'socket';
    -- Client:
    mysql --socket=/var/run/mysqld/mysqld.sock -u app -p

相关错误

更多连接和客户端错误

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

// 错误更少,修复更快

在 SQLly 中使用 MySQL

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