如何修复 MySQL 错误 2003：无法连接到“localhost:3306”上的 MySQL 服务器

已发表: 2024-03-25

MySQL 错误 2003 无法连接到“localhost:3306”上的 MySQL 服务器 (10061) 意味着您的应用程序或工具正在尝试使用默认端口 3306 连接到“localhost”上的 MySQL 数据库服务器，但失败。错误消息也告诉你什么。在讨论修复 MySQL 错误 2003 (HY000) 的方法之前，了解一些关键术语、导致问题的原因以及将来如何避免它们非常重要。

 错误 2003 (HY000)：无法连接到“localhost”上的 MySQL 服务器 (10061)

MySQL 错误 2003 是什么意思？

MySQL 服务器通过端口 3306 托管在“localhost”（您自己的计算机）上。此错误消息表明通信出现故障，这意味着连接到 MySQL 服务器的尝试不成功。错误消息中有一些术语需要澄清。他们是这样的：

MySQL Server是MySQL的数据库服务器软件，用于存储、恢复和管理数据。

MySQL 中的HY000错误代码是未指定问题的通用错误标记，在更具体的错误代码不适用时使用。

“localhost:3306” (10061)是指尝试使用端口 3306 连接到在“localhost”（发出请求的计算机）上运行的 MySQL 服务器失败，错误代码 10061 指示服务器未主动侦听指定端口。

现在解释完术语后，是时候看看导致此错误的原因了。

MySQL为什么会出现2003错误？

此问题有几个潜在原因。让我们把它们分解一下。

MySQL 服务器未运行：最简单的情况是，此错误可能意味着您尝试访问的 MySQL 服务器未运行。

防火墙阻止：如果您的防火墙已配置为阻止端口 3306 上的传入连接，则您的连接尝试将失败。

连接设置不正确：这可能是由于在连接字符串中使用了错误的端口、主机名甚至 IP 地址。

网络问题：有时，问题可能不在于您这边或 MySQL 本身，而在于两者之间的网络。这可能包括从简单的网络中断到更复杂的 DNS 解析问题。

了解 MySQL 错误 2003 背后的原因是排除故障的第一步。如果不看到根源，无论是在现场还是本地环境中，都很难解决任何问题。

MySQL错误2003是如何出现的？

MySQL 中的错误 2003 可能会以各种形式显示，具体取决于您的设置细节和连接方法。尽管错误消息可能有所不同，但原因和修复步骤通常保持不变。

以下是此错误可能出现的一些常见方式：

错误 2003: Can't connect to MySQL server on '127.0.0.1:3306' ：此消息明确指出尝试使用 IP 地址 127.0.0.1（默认情况下本地主机的环回 IP 地址）连接到 MySQL端口 3306。这表明连接尝试不成功，可能是由于服务器未运行或防火墙阻止访问。

MySQL 错误 2003

无法通过套接字“/var/lib/mysql/mysql.sock”连接到本地 MySQL 服务器：这种变化主要发生在 Unix 和 Linux 环境中。它表明客户端正在尝试通过 Unix 套接字文件（在本例中为 /var/lib/mysql/mysql.sock）进行连接，但该文件要么不存在，要么服务器未运行，要么存在权限问题阻止使用权。

MySQL Workbench 错误代码 2003：使用 MySQL Workbench 时，此错误会显示相同的代码，但通常伴有更用户友好的解释。这仍然意味着连接到 MySQL 服务器时出现问题，这可能是由于上述任何原因或与 MySQL Workbench 配置相关的特定问题造成的。

每条消息都包含有关错误原因的提示。在选择如何修复错误之前，您可以仔细阅读该消息。

如何修复 MySQL 错误 2003？

修复 MySQL 错误 2003“localhost:3306”涉及几个步骤，以确保您的 MySQL 服务器可访问并正确配置连接。以下是您可以在不同操作系统上执行的步骤。

1.确保MySQL服务器正在运行

首先，验证 MySQL 服务器是否正在您的计算机上运行。如果服务器未运行，则任何连接尝试都不会成功。

在 Linux 上

通过在终端中运行“ sudo systemctl status mysql ”来检查 MySQL 服务的状态。
使用“ sudo systemctl start mysql”启动服务。

在 Windows 上

打开服务应用程序（在“开始”菜单中搜索它）。
向下滚动找到MySQL 服务并检查其状态。
如果它没有运行，请右键单击它并选择“启动” 。

2.检查防火墙设置

正如我们之前讨论的，防火墙可以通过阻止端口 3306（MySQL 使用的默认端口）来阻止连接到 MySQL。要检查错误是否来自防火墙，您可以采取以下步骤。

在 Linux 上

要管理防火墙设置，请使用“ ufw ” （简单防火墙）。
要允许 MySQL 流量，请使用` sudo ufw allowed 3306` 。

在 Windows 上

打开Windows Defender 防火墙。
转到高级设置。
检查入站规则是否有任何阻止端口 3306 的规则
相应地调整它们。

3.验证MySQL服务器配置

MySQL 配置文件（ Linux 上为“ my.cnf” ， Windows 上为“ my.ini ”）具有网络连接的关键设置。确保文件设置正确：

- 端口应设置为 3306。

- “ bind-address”应该在行首用“#”注释掉，或者设置为“ 127.0.0.1 ”以接受来自本地主机的连接。如果您要远程连接，则可能会设置为“ 0.0.0.0 ”或服务器的特定 IP 地址。

您通常可以在 Linux上的“ /etc/mysql/ ”下找到“ my.cnf” ，或者在 Windows 上的MySQL 安装目录中找到“ my.ini ”。

4. 检查网络配置

确保您的网络设置不会导致问题。验证“localhost”是否解析为“ 127.0.0.1 ” ：

在 Linux 上：

打开终端 → 输入` ping localhost` → 按Enter 键以 ping 本地主机。
您应该看到指示“localhost”解析到的 IP 地址的响应，该地址应该是“ 127.0.0.1 ” 。
如果响应显示`127.0.0.1` ，则 `localhost` 已正确解析。按Ctrl + C停止 ping 过程。

在 Windows 上：

打开命令提示符 → 输入` ping localhost` → 按Enter 键以 ping 本地主机。
在响应中查找 IP 地址。
如果输出包含`127.0.0.1` ，则您的 `localhost` 设置正确。
关闭窗口即可退出。

确保您的主机文件中没有条目将 ` localhost ` 重定向到不同的 IP。主机文件位于Linux上的“ /etc/hosts ”和 Windows 上的“ C:\Windows\System32\drivers\etc\hosts ” 。

5. 使用 TCP/IP 连接

当使用 MySQL Workbench 等工具连接到数据库时，请确保连接方法设置为TCP/IP 。TCP/IP 连接更加通用，特别是在套接字文件存在配置问题的情况下。

打开 MySQL Workbench → 访问连接设置 → 选择连接选项卡 → 从列表中选择连接方法为“标准 (TCP/IP)” → 确认设置

确保正确输入其他详细信息，例如主机名（通常是 localhost）、端口（默认为 3306）、用户名和密码。

单击“测试连接”按钮，验证 MySQL Workbench 是否可以使用 TCP/IP 成功连接到 MySQL 服务器。

结论

MySQL 错误 2003 表示无法连接到“localhost:3306”上的 MySQL 服务器。对于数据库管理员和开发人员来说，这是一个常见但可以解决的挑战。此错误本质上是应用程序和 MySQL 服务器之间的通信故障，可能由多种根本原因造成，包括 MySQL 服务器关闭、防火墙限制、连接设置不正确或网络问题。

了解 MySQL Error 2003 的复杂性对于有效排除故障至关重要。从错误代码 (HY000) 的细节到尝试连接到端口 3306 上的“localhost”的含义，每个细节都可以让您深入了解当前问题的本质。

阅读完本指南后，您应该已经解决了 MySQL 错误 2003，所以恭喜您！