MySQL错误2002表示客户端无法通过socket连接本地MySQL服务器，根本原因是未连上mysqld进程，常见于服务未启动、socket路径不匹配、端口被占或权限限制。
MySQL报错 2002 是什么问题
2002 是 MySQL 客户端连接失败时最典型的错误码，含义是：Can't connect to local MySQL server through socket '/tmp/mysql.sock'（或类似路径）。本质不是认证失败，而是**根本没连上 mysqld 进程**——可能是服务没启、端口被占、socket 文件路径不对，或者权限/网络限制导致连接被拒。
检查 mysqld 是否正在运行
很多情况下，2002 就是因为 MySQL 服务压根没起来。别急着改配置，先确认进程状态：
- Linux/macOS：运行
ps aux | grep mysqld，看是否有mysqld进程；或用systemctl status mysql（Ubuntu/Debian）或systemctl status mysqld（CentOS/RHEL） - macOS Homebrew 安装的：可能要用
brew services list | grep mysql - Windows：打开“服务”管理器，找
MySQL80或对应服务名，确认状态是“正在运行” - 如果进程不存在，直接启动：
sudo systemctl start mysql或brew services start mysql
确认 socket 文件路径是否匹配
客户端默认通过 Unix socket（而非 TCP）连接本地 MySQL，但客户端和服务器配置的 socket 路径不一致就会报 2002。常见原因：
- MySQL 配置文件（
/etc/my.cnf或/usr/local/etc/my.cnf）中[mysqld]段写了socket = /var/run/mysqld/mysqld.sock，但客户端（如mysql -u root）仍按默认/tmp/mysql.sock去连 - 解决方法：显式指定 socket 路径，例如
mysql -u root --socket=/var/run/mysqld/mysqld.sock - 或统一配置：在
[client]段也写上相同socket = ...，避免每次手动传参 - 用
mysql --help | grep "Default options"可查客户端实际加载的配置顺序和位置
尝试用 TCP 连接绕过 socket 问题
如果 socket 路径混乱或权限受限（比如非 root 用户无法读 /var/run/mysqld/），可强制走 TCP 协议测试是否服务本身正常：
- 执行
mysql -h 127.0.0.1 -P 3306 -u root -p（注意是127.0.0.1，不是localhost；后者会触发 socket 连接） - 若成功，说明 mysqld 在运行且监听了 TCP 端口，问题纯属 socket 配置或权限；若仍失败，检查
bind_address是否为127.0.0.1或0.0.0.0，以及防火墙是否放行 3306 - 确认监听状态：
ss -tlnp | grep :3306或netstat -an | grep 3306
真正麻烦的往往不是服务没启，而是 socket 路径在配置里藏了三层、my.cnf 被多个地方覆盖、或者 Docker 容器里挂载路径错位——这些地方容易漏查，建议优先用 mysql --print-defaults 和 mysqld --verbose --help | grep socket 对比两端实际生效的 socket 值。
