你的客户端程序（比如命令行 mysql、Navicat、DBeaver 等）尝试通过一个叫做“Unix Socket”的特殊文件来连接本地的 MySQL 服务器，但它找不到这个文件，或者无法访问它。
这通常不是指你的用户名或密码错误（那个错误码是 1045），而是连接的“路径”或“服务本身”出了问题。
下面我将为你详细拆解可能的原因和对应的解决方案,请按照顺序逐一排查。
问题根源分析
你需要理解 MySQL 的两种本地连接方式：
- TCP/IP 连接 (localhost:3306)：就像连接网络上的另一台电脑一样，通过 IP 地址
0.0.1和端口3306进行连接。 - Unix Socket 连接：在 Unix-like 系统（Linux, macOS）上，客户端和服务器在同一台机器上时，可以通过一个文件（Socket 文件）进行通信，这通常比 TCP/IP 更快。
错误 2002 通常与 Unix Socket 连接失败 有关。
排查步骤（从最常见到最罕见）
第 1 步：确认 MySQL 服务是否正在运行
这是最常见的原因，MySQL 服务根本没有启动，自然不会有 Socket 文件。
如何检查和启动：
-
在 Linux (使用 systemd, 如 Ubuntu 16+, CentOS 7+)：
# 检查服务状态 sudo systemctl status mysql # 如果没有运行，启动它 sudo systemctl start mysql # 设置为开机自启 sudo systemctl enable mysql
-
在 Linux (使用 SysVinit, 如 CentOS 6, Ubuntu 14)：
（图片来源网络，侵删）# 检查服务状态 sudo service mysql status # 如果没有运行，启动它 sudo service mysql start
-
在 macOS (使用 Homebrew)：
# 检查服务状态 brew services list # 如果没有运行，启动它 brew services start mysql
-
在 Windows：
- 按
Win + R，输入services.msc并回车。 - 在服务列表中找到
MySQL相关的服务（如MySQL80）。 - 确认其“状态”为“正在运行”，“启动类型”为“自动”或“手动”，如果不是，右键选择“启动”。
- 按
第 2 步：找到正确的 Socket 文件路径并检查
有时候服务在运行，但客户端配置的 Socket 路径和服务器实际的不一致。
-
找到 MySQL 实际使用的 Socket 文件路径： 你可以通过以下几种方式找到它：
-
查看配置文件：
my.cnf或my.ini，在[mysqld]和[client]段落中寻找socket = /path/to/socket/file。 -
使用 MySQL 命令（需要能登录进去）：
-- 查询服务器端的 socket 路径 SHOW VARIABLES LIKE 'socket'; -- 查询客户端默认的 socket 路径 -- (如果连接不上，这个命令可能执行不了)
-
使用
ps命令（Linux/macOS）：ps aux | grep mysql
你可能会在输出中看到
--socket=/var/run/mysqld/mysqld.sock或类似参数。
-
-
检查该文件是否存在且可访问： 找到路径后，用
ls命令检查：# 假设路径是 /var/run/mysqld/mysqld.sock ls -l /var/run/mysqld/mysqld.sock
- 如果文件不存在：说明服务可能异常退出，或者配置文件路径错误，回到第 1 步，尝试重启 MySQL 服务。
- 如果文件存在：检查它的所有者和权限，它应该属于
mysql用户和mysql组，并且有读写权限。# 示例输出：srw-rw---- 1 mysql mysql 0 ... # 这表示所有者是 mysql，组是 mysql，其他用户没有权限。 # 如果所有者是 root，或者权限不对，可能导致客户端无法连接。
第 3 步：使用 TCP/IP 方式连接（绕过 Socket）
这是一种非常有效的诊断方法，TCP/IP 方式能连上，那 100% Socket 的问题。
- 在命令行中：
默认情况下，
mysql -u root -p尝试使用 Socket，你可以强制使用 TCP/IP：# 使用 127.0.0.1 代替 localhost mysql -u root -p -h 127.0.0.1
- 如果这个命令成功了：说明你的 MySQL 服务器配置为只监听 Socket，或者 Socket 配置有问题，你需要检查客户端的配置文件（如
~/.my.cnf或/etc/my.cnf），在[client]段落里，要么注释掉socket行,要么把它改成正确的路径。 - 如果这个命令也失败了：那么问题更严重，可能是 MySQL 服务根本没有在监听任何端口（3306）,或者有防火墙阻止了连接。
- 如果这个命令成功了：说明你的 MySQL 服务器配置为只监听 Socket，或者 Socket 配置有问题，你需要检查客户端的配置文件（如
第 4 步：检查端口 3306 是否被监听和防火墙
TCP/IP 方式也失败,问题可能出在网络上。
-
检查 MySQL 是否在监听 3306 端口：
# Linux/macOS sudo netstat -tuln | grep 3306 # 或者使用更现代的 ss 命令 sudo ss -tuln | grep 3306 # Windows netstat -an | findstr "3306"
- 如果没有任何输出：说明 MySQL 根本没有在监听 TCP 端口，这通常是因为 MySQL 的配置文件（
my.cnf）中的bind-address被设置为了0.0.1之外的地址，或者被注释掉了（在某些版本中，注释掉意味着不监听任何 TCP 端口），你需要编辑my.cnf，确保bind-address = 127.0.0.1或bind-address = 0.0.0.0（后者监听所有地址）。 - 如果有输出，
0.0.0:3306或0.0.1:3306,说明服务本身没问题。
- 如果没有任何输出：说明 MySQL 根本没有在监听 TCP 端口，这通常是因为 MySQL 的配置文件（
-
检查防火墙： 防火墙可能会阻止你连接到 3306 端口。
-
Linux (iptables/firewalld)：
# 检查 firewalld (CentOS 7+, Fedora) sudo firewall-cmd --list-ports # 3306/tcp 没有开放，添加它 sudo firewall-cmd --permanent --add-port=3306/tcp sudo firewall-cmd --reload # 检查 ufw (Ubuntu) sudo ufw status # 如果没有允许，则允许 sudo ufw allow 3306/tcp
-
Windows 防火墙：
- 进入“控制面板” -> “系统和安全” -> “Windows Defender 防火墙”。
- 点击“允许应用或功能通过 Windows Defender 防火墙”。
- 找到 MySQL 相关的程序，确保其“专用”和“公用”网络复选框都已勾选。
-
第 5 步：检查 MySQL 配置文件 (my.cnf)
这是一个更深层的原因。my.cnf 文件中的 [client] 和 [mysqld] 段落定义了客户端和服务器的行为。
-
检查
[client]段落：[client] # 确保这里的 socket 路径是正确的，或者被注释掉 # socket = /var/run/mysqld/mysqld.sock user = your_username password = your_password
如果这里的
socket路径是错的,所有客户端工具都会失败。 -
检查
[mysqld]段落：[mysqld] # 确保服务器端的 socket 路径是有效的 socket = /var/run/mysqld/mysqld.sock # 确
