连接报错 2002 是什么
ERROR 2002 (HY000): Can't connect to local MySQL server through socket 表示客户端尝试走本地 Unix socket 连接，但没能打开那个 socket 文件。原因通常有三类：服务端没启动、socket 文件路径与客户端预期不一致、文件权限或 SELinux 策略不允许访问。它与走 TCP 的「连接被拒绝」不同——路径和权限问题占多数，且容器化与面板环境下最容易发生。
基本信息
| 适用版本 | MySQL 5.7 / 8.0、MariaDB；Linux / Unix 环境（Windows 用命名管道或 TCP） |
|---|---|
| 错误码 | ERROR 2002 (HY000) |
| 含义 | socket 文件缺失、路径不符或权限不足 |
| 定位参数 | SHOW VARIABLES LIKE 'socket'、mysql --help | grep socket |
| 绕过方式 | 改用 TCP（-h 127.0.0.1）或显式指定 -S socket 路径 |
| 常见环境差异 | 宝塔面板常在 /tmp/mysql.sock，源码编译常在数据目录下 |
典型使用场景
- 本地执行 mysql 客户端报 2002，需要判断是服务未启动还是路径不符
- 迁移或容器化之后，容器内外 socket 路径不一致导致连接失败
- 面板环境与手工安装混用，客户端读到的路径与实例不同
- 备份脚本在本机执行失败，因默认走 socket 而目标实例只开了 TCP
- 排查权限问题：socket 文件存在但属主与权限不允许客户端访问
排查命令
排查命令
# 看服务端实际使用的 socket 路径
mysql -uroot -p -e "SHOW VARIABLES LIKE 'socket';"
# 直接查看候选路径是否存在、权限如何
ls -l /var/lib/mysql/mysql.sock /tmp/mysql.sock 2>/dev/null
# 看客户端默认 socket 路径（来自配置文件或编译默认值）
mysql --help | grep -A1 'Default options'
my_print_defaults client | grep socket
# 确认服务是否在运行
systemctl status mysqld 2>/dev/null || systemctl status mariadb修复与绕过
修复与绕过
# 绕过方式一：改走 TCP（同时要确认 bind-address 允许）
mysql -h 127.0.0.1 -P 3306 -uroot -p
# 绕过方式二：显式指定 socket 文件
mysql -uroot -p -S /var/lib/mysql/mysql.sock
# 根治：把 socket 路径写进客户端配置
# ~/.my.cnf 或 /etc/my.cnf
[client]
socket=/var/lib/mysql/mysql.sock常见原因对照
| 现象 | 原因 | 处理 |
|---|---|---|
| 文件完全不存在 | 服务未启动或 socket 路径配置改变 | 启动服务并核对 socket 参数 |
| 文件存在但连接失败 | 路径与客户端预期不符 | 用 -S 指定或写入客户端配置 |
| 权限被拒绝 | 目录或文件权限不足、SELinux 拦截 | 核对属主与权限，检查 audit.log |
| 容器内外不一致 | 挂载路径与容器内配置不同 | 统一挂载路径或改走 TCP |
| 能连但报数据库不存在 | 连上了另一个实例的 socket | 确认 socket 归属与实例对应关系 |
宝塔面板环境的 socket 常在 /tmp/mysql.sock，源码编译安装常在数据目录下，容器内又可能是第三条路径：路径一旦错位，本机客户端连不上而远程 TCP 连接却正常，这是判断方向的关键线索。
服务重启会重建 socket 文件：长期运行的应用若依赖 socket 连接且未做重连，重启后会持续报错；SELinux 或防火墙策略变更也可能导致同类错误，排查时记得同时看系统日志与审计日志。