2002 - Can‘t connect to server on ‘localhost‘ (10061)

报错信息

解决方案

这个错误2002 - Can't connect to server on 'localhost' (10061)很常见，10061这个代码在Windows上明确表示“目标计算机积极拒绝连接”，意味着服务器没有在指定的端口（默认3306）上监听你的请求。

🎯 第一步：检查MySQL服务是否运行 (最常见原因)

绝大多数情况都是因为MySQL服务没有启动。

• Windows系统：

  1. 按Win + R键，输入services.msc并回车，打开“服务”窗口。
  2. 在列表中找到你的MySQL服务。服务名可能不叫“MySQL”，常见的有MySQL80、MySQL57或MariaDB。
  3. 查看服务“状态”。如果是“已停止”，右键点击它，选择“启动”。
     

• Linux/macOS系统：
  打开终端，根据你的系统和服务管理器，尝试以下命令：

  # 对于使用 systemd 的系统 (如 Ubuntu 16.04+)sudosystemctl status mysql# 或sudosystemctl status mariadb# 对于使用 SysV init 的旧系统sudoservicemysql status# 或sudoservicemariadb status

  如果服务未运行，将status替换为start来启动它。

🔍 第二步：如果服务已运行，检查端口与配置

如果服务正在运行但依然报错，问题可能出在端口或配置上。

1. 检查端口是否被监听：
   打开命令行（Windows）或终端（Linux/macOS），执行：

   • Windows:netstat -ano | findstr :3306
   • Linux/macOS:netstat -an | grep 3306
     如果没有任何输出，说明MySQL服务没有在默认的3306端口上监听。

2. 检查MySQL配置文件 (my.ini或my.cnf)：
   找到配置文件，检查其中的bind-address设置。

   • 如果设置为bind-address = 127.0.0.1，只允许本地连接，这是正常的。
   • 如果设置为其他具体IP，可能会导致连接不上。
   • 不建议为了测试随意改为0.0.0.0，这会有安全风险。

3. 检查防火墙：
   确保防火墙没有阻止3306端口。可以临时禁用防火墙来测试。如果是，需添加允许规则。

🛠️ 第三步：其他可能原因与深度排查

如果以上步骤都没解决问题，可以尝试以下方法：

• 更换连接地址：尝试将连接地址从localhost改为127.0.0.1。因为localhost有时会优先尝试使用Socket文件，而127.0.0.1强制使用TCP/IP连接。
• 检查用户权限：确认你使用的MySQL用户有从localhost或127.0.0.1连接的权限。
• 查看错误日志：MySQL的错误日志通常包含更详细的失败原因，这是定位问题的关键线索。
• 检查端口占用：如果3306端口被其他程序占用，也会导致冲突。