ERROR 2002 (HY000) 表明客户端无法通过socket连接MySQL服务，核心原因是mysqld进程未运行、socket路径配置不一致、socket文件缺失或权限不足、或目录不可写；需依次检查进程状态、配置文件中[mysqld]与[client]段socket路径是否一致、/var/run/mysqld/目录存在且属主为mysql、并可用mysql -h 127.0.0.1绕过socket验证TCP连通性。
mysql报错ERROR 2002：先确认mysqld进程是否真在跑
ERROR 2002 不是密码错、也不是权限问题，而是客户端压根没触碰到 mysqld 进程。最常踩的坑是：以为服务在运行，其实早挂了。
- Linux/macOS：运行
ps aux | grep mysqld，只保留含mysqld且不是grep自身的那一行；或者用systemctl status mysql（Debian/Ubuntu）或systemctl status mysqld（CentOS/RHEL） - macOS Homebrew：执行
brew services list | grep mysql，状态必须是started - Windows：打开
services.msc，找 MySQL80 或类似名称的服务，状态得是“正在运行” - 如果进程不存在，直接启动：
sudo systemctl start mysql或brew services start mysql；若启动失败，立刻查日志：sudo journalctl -u mysql --since "10 minutes ago"
如何查清mysqld.sock实际路径和配置是否一致
客户端默认找 /tmp/mysql.sock，但 mysqld 可能建在 /var/run/mysqld/mysqld.sock 或 /var/lib/mysql/mysql.sock —— 路径不匹配就报 2002，连文件都找不到。
- 查 mysqld 实际监听的 socket（需能连上）：
mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';" - 查配置文件里写的路径：
grep -A 5 '\[mysqld\]' /etc/my.cnf /etc/mysql/my.cnf 2>/dev/null | grep socket - 查客户端加载的默认配置顺序：
mysql --print-defaults，它会列出所有被读取的配置文件路径 - 临时验证：用绝对路径直连，比如
mysql -u root -p --socket=/var/run/mysqld/mysqld.sock - 永久修复：在配置文件的
[client]段补上和[mysqld]段完全一致的socket = /xxx/mysql.sock
mysql.sock 文件缺失或权限不对怎么办
即使配置正确，/var/run/mysqld/ 目录不存在、属主不是 mysql、或权限太严，sock 文件就建不出来 —— 客户端自然连不上。
- 检查目录是否存在且权限正确：
ls -ld /var/run/mysqld/，输出应类似drwxr-xr-x 2 mysql mysql - 若目录不存在，手动创建并赋权：
sudo mkdir -p /var/run/mysqld && sudo chown mysql:mysql /var/run/mysqld && sudo chmod 755 /var/run/mysqld - 某些 systemd 系统依赖
RuntimeDirectory=mysqld自动管理该目录，此时要检查/usr/lib/systemd/system/mysql.service是否漏了这一行 - Docker 场景下特别注意：挂载卷覆盖了
/var/run/mysqld，导致 sock 无法写入 —— 改用tmpfs挂载或确保宿主机目录可写
用 127.0.0.1 绕过 socket 是最快验证手段
只要 mysqld 在监听 TCP，mysql -h 127.0.0.1 -P 3306 -u root -p 就能连上。这招不解决根本问题，但能快速区分是 socket 配置问题，还是服务本身异常。
-
localhost触发 Unix socket 连接；127.0.0.1强制走 TCP —— 这个区别必须记住 - 连得上
127.0.0.1但连不上localhost：100% 是 socket 路径或权限问题 - 连不上
127.0.0.1：检查bind_address是否设为127.0.0.1或0.0.0.0，再用ss -tlnp | grep :3306确认端口是否真在监听 - 想让所有本地连接默认走 TCP：在配置文件
[mysql]段加protocol=tcp，避免每次敲-h 127.0.0.1
my.cnf 写错了，而是 /var/run/mysqld/ 目录被重装系统清空、Docker 挂载覆盖了 runtime 路径、或 SELinux 拦截了 socket 创建 —— 这些不会报错，只会让 mysqld.sock 静静消失。 
