连接本地和服务器 MySQL 时出现 2003-Can’t connect to MySQL server on ‘localhost’(10061) 错误，如何解决？

连接本地 MySQL 时出现 2003-Can’t connect to MySQL server on ‘localhost’(10061) 错误，如何解决？

在日常的 MySQL 开发或运维中，经常会遇到连接 MySQL 数据库时出现 2003 - Can't connect to MySQL server on 'localhost' (10061) 错误。这类问题不仅仅出现在特定操作系统或 MySQL 版本下，也可能由多种因素导致。为了帮助开发者或运维人员快速解决这个问题，我们将从不同的操作系统环境、MySQL 版本、配置问题等多个维度进行详细分析，并列出可能的解决方案，并给出对应的解决方案优先级。

一、错误原因分析

首先，我们需要了解该错误的原因。2003 - Can't connect to MySQL server on 'localhost' (10061) 错误通常表明客户端无法在指定的端口上与 MySQL 服务建立连接，可能的原因包括：

• MySQL 服务没有启动或崩溃。
• 防火墙阻止了端口访问。
• MySQL 配置文件中设置了错误的绑定地址（bind-address）。
• 客户端和 MySQL 服务器之间的网络问题。
• MySQL 端口被其他程序占用。
• 服务器上的某些网络设置或安全策略限制了连接。

二、MySQL 版本分析

1. MySQL 5.7

MySQL 5.7 是一个比较稳定的版本，但在安装和配置过程中，如果没有正确配置某些选项，可能会遇到 2003 错误。

解决方案：

检查 MySQL 服务是否启动：使用以下命令查看 MySQL 服务是否正常运行：

sudo service mysql status

如果没有启动，请使用以下命令启动：

sudo service mysql start

检查 bind-address 设置：MySQL 5.7 默认可能将 bind-address 设置为 127.0.0.1，如果你的 MySQL 服务器配置文件（my.cnf 或 my.ini）中 bind-address 为 0.0.0.0 或正确设置为 localhost，确保它没有被错误配置为某个不正确的地址：

bind-address = 127.0.0.1

查看防火墙设置：检查防火墙是否阻止了 MySQL 的端口（默认为 3306）：

sudo ufw allow 3306

MySQL 用户权限：确保 MySQL 用户具有从 localhost 连接的权限。如果需要，可以使用以下命令授予权限：

GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'password';

解决方案权重：🌟🌟🌟

2. MySQL 8

MySQL 8 引入了一些新特性和变化，例如改进的身份验证插件和更严格的安全设置，这可能会影响连接。

解决方案：

检查身份验证插件：MySQL 8 默认使用 caching_sha2_password 身份验证插件，较旧的客户端可能不支持此插件。可以在 my.cnf 文件中将默认的身份验证插件更改为 mysql_native_password，以便支持旧客户端：

default_authentication_plugin = mysql_native_password

防火墙和端口检查：同 MySQL 5.7 的解决方法，确保防火墙未阻止 3306 端口。

检查配置文件：确保 bind-address 设置正确，并且没有被不小心修改为 0.0.0.0。

bind-address = 127.0.0.1

检查用户权限：使用以下 SQL 语句来确保 MySQL 用户可以从本地连接：

GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'password';

解决方案权重：🌟🌟🌟🌟

三、操作系统分析（详细版）

连接 MySQL 时出现 2003 - Can't connect to MySQL server on 'localhost' (10061) 错误，操作系统环境是一个重要的因素，不同操作系统可能会对 MySQL 服务的运行产生不同影响。我们将分别详细分析 Windows 10、Windows 11、Linux、macOS 和 Ubuntu 等常见操作系统的相关问题和解决方案。

1. Windows 10

在 Windows 10 上，MySQL 可能会因为服务未启动、防火墙阻挡、端口占用或权限问题等导致 2003 错误。下面我们将逐步解决这些问题。

解决方案：

确认 MySQL 服务是否启动：

在 Windows 上运行 MySQL 服务器通常是通过服务管理来控制的。使用以下命令检查 MySQL 服务是否正在运行：

打开“任务管理器”，切换到“服务”标签，查看 MySQL 服务的状态。

如果 MySQL 没有启动，可以手动启动它。打开命令提示符并输入：

net start MySQL

检查 MySQL 配置文件： 确保 MySQL 的配置文件 my.ini 中没有将 bind-address 错误配置为除 127.0.0.1 或 localhost 之外的其他地址。正确配置 bind-address 可以防止 MySQL 被外部网络访问：

bind-address = 127.0.0.1

检查防火墙设置：

Windows 防火墙可能阻止了 MySQL 的默认端口 3306。可以在防火墙中创建规则允许 MySQL 端口的流量：

1. 打开控制面板 -> 系统和安全 -> Windows 防火墙 -> 高级设置 -> 入站规则。
2. 新建入站规则，选择端口，指定端口号 3306，并允许连接。

检查 MySQL 用户权限：

在 MySQL 中，用户权限的配置也可能导致连接失败。确保你使用的数据库用户拥有从 localhost 连接的权限：

GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

解决方案权重：🌟🌟🌟

2. Windows 11

与 Windows 10 相比，Windows 11 在网络安全和防火墙策略方面可能会有一些新的设置，导致 MySQL 无法正常启动或连接。

解决方案：

禁用 Windows 防火墙：

在排查网络连接问题时，暂时禁用防火墙是一个常见的排除法。可以通过以下命令禁用防火墙：

netsh advfirewall set allprofiles state off

但建议在确认问题后重新启用防火墙，并适当配置防火墙规则。

检查服务启动状态：

打开“任务管理器”，确认 MySQL 服务是否运行。如果 MySQL 没有运行，可以在命令行使用：

net start MySQL

更新 MySQL 配置文件：

确保 MySQL 配置文件中的 bind-address 设置正确。可以通过如下设置强制 MySQL 绑定到 localhost：

bind-address = 127.0.0.1

查看 MySQL 错误日志：

如果 MySQL 无法启动，查看 MySQL 错误日志获取更详细的错误信息，日志通常位于 C:\ProgramData\MySQL\MySQL Server 8.0\data\ 目录下。

解决方案权重：🌟🌟

3. Linux（例如 Ubuntu）

Linux 系统上的 MySQL 服务和连接问题通常与用户权限、配置文件、服务状态以及防火墙设置等有关。我们将分别详细列举解决步骤。

解决方案：

检查 MySQL 服务状态：

在 Linux 系统上，MySQL 服务通常是通过 systemd 或 init.d 启动的。首先，检查 MySQL 服务是否正常运行：

sudo systemctl status mysql

如果服务没有启动，可以使用以下命令启动：

sudo systemctl start mysql

若要让 MySQL 服务在系统启动时自动启动：

sudo systemctl enable mysql

检查 MySQL 配置文件：

打开 MySQL 配置文件 /etc/mysql/my.cnf 或 /etc/mysql/mysql.conf.d/mysqld.cnf，确保 bind-address 设置为 127.0.0.1 或 localhost，以避免从外部访问：

bind-address = 127.0.0.1

检查防火墙设置：

在 Ubuntu 中，默认的防火墙是 ufw。使用以下命令检查 MySQL 端口是否开放：

sudo ufw status

如果没有开放 3306 端口，执行以下命令来允许访问：

sudo ufw allow 3306

如果不使用 ufw，也可以使用 iptables 进行配置。

检查 MySQL 错误日志：

查看 MySQL 错误日志 /var/log/mysql/error.log 或 /var/log/mysql/mysql-error.log，确认是否有错误信息，以便进一步定位问题。

查看系统资源限制：

如果系统资源过于紧张（如内存或磁盘空间），也可能导致 MySQL 无法启动。通过以下命令查看系统资源状态：

free -h   # 查看内存
df -h     # 查看磁盘

解决方案权重：🌟🌟🌟🌟🌟

4. macOS

macOS 上的 MySQL 也可能遇到类似的问题，通常是由于 MySQL 服务未启动或防火墙设置不当。macOS 上的 MySQL 服务管理与 Linux 相似，因此我们可以按类似方式进行排查。

解决方案：

启动 MySQL 服务：

如果 MySQL 服务没有启动，可以使用以下命令启动它：

sudo /usr/local/mysql/support-files/mysql.server start

检查防火墙设置：

macOS 使用 pf 防火墙，可以使用以下命令查看当前防火墙规则：

sudo pfctl -sr

如果需要，可以通过 pfctl 命令手动允许端口 3306 的流量。

检查 MySQL 配置文件：

打开 MySQL 配置文件，确保 bind-address 设置为 127.0.0.1：

bind-address = 127.0.0.1

检查系统日志：

如果 MySQL 服务启动失败，查看系统日志文件 /var/log/system.log 以获取更多信息。

解决方案权重：🌟🌟🌟

5. Ubuntu（详细版）

Ubuntu 和 Linux 系统的配置和排查步骤非常类似，但 Ubuntu 提供了更便捷的包管理系统和服务管理工具，帮助开发者和管理员更轻松地处理 MySQL 服务的问题。

解决方案：

检查 MySQL 服务：

使用以下命令检查 MySQL 服务状态：

sudo systemctl status mysql

如果 MySQL 服务未启动，使用以下命令启动：

sudo systemctl start mysql

如果服务没有正常启动，可以查看 MySQL 错误日志 /var/log/mysql/error.log 以进一步调查。

检查防火墙设置：

默认情况下，Ubuntu 使用 ufw 来管理防火墙。可以通过以下命令确认 3306 端口是否开放：

sudo ufw status

如果没有开放 3306 端口，可以运行：

sudo ufw allow 3306

查看 MySQL 配置文件：

确保 bind-address 设置为 127.0.0.1，而不是 0.0.0.0 或其他不适合本地连接的 IP 地址。

解决方案权重：🌟🌟🌟🌟

总结

通过对不同操作系统（Windows 10、Windows 11、Linux、macOS 和 Ubuntu）的详细分析，我们了解了 MySQL 连接问题可能的原因以及如何逐一解决。操作系统层面的配置和服务状态是解决 MySQL 2003 错误的关键所在，确保服务正常启动、配置文件正确、网络和防火墙设置得当是解决问题的主要步骤。希望这部分内容能帮助大家在不同的操作系统环境下高效解决问题。