在使用 MySQL 数据库时，常常会遇到一些连接问题，其中“2002 - Can't connect to server on 'localhost' (10061)”是一个常见的错误提示。这意味着客户端无法与 MySQL 服务器建立连接。下面我们将探讨该问题的成因以及解决方法。
1. 错误原因分析
该错误通常由以下几种原因引起：
-
MySQL 服务器未启动：最常见的原因是 MySQL 服务没有运行。可以通过 MySQL 控制台或服务管理工具检查该服务的状态。
-
主机配置问题：连接字符串中的主机名（例如 ‘localhost’）可能未正确设置，或是 MySQL 配置文件中没有正确配置绑定地址。
-
防火墙设置：在某些情况下，操作系统的防火墙可能阻止了访问数据库服务的请求。
-
端口配置问题：MySQL 默认端口是 3306，如果被改变或被其他应用占用，也会导致连接失败。
2. 解决方案
针对以上可能的原因，我们可以逐一排查并解决。
2.1 检查 MySQL 服务状态
在 Windows 系统中，可以按下 Win + R 键，输入 services.msc，打开服务管理器，查找 MySQL 或 MySQL80 服务。确保该服务的状态为“正在运行”。如果未启动，可以右键点击选择“启动”。
在 Linux 系统中，可以通过以下命令检查 MySQL 服务状态：
sudo systemctl status mysql
如果服务没有运行，可以使用以下命令启动：
sudo systemctl start mysql
2.2 检查配置文件
MySQL 的配置文件通常位于 /etc/mysql/my.cnf 或 Windows 的类似路径中。在配置文件中查找 bind-address 选项。默认情况下，它可能被设置为 127.0.0.1（即只允许本地连接）。确保该地址正确或被注释掉，从而允许远程连接：
# bind-address = 127.0.0.1
2.3 检查防火墙设置
如果你使用的是 Windows 防火墙或 Linux 上的 UFW，可以检查防火墙规则，看是否允许 3306 端口的连接。在 Windows 中，可以通过控制面板进入防火墙设置，并允许 MySQL 通过；在 Linux 中，使用以下命令：
sudo ufw allow 3306/tcp
2.4 检查端口占用情况
如果 MySQL 服务运行了，但仍然无法连接，则可能是端口问题。可以使用以下命令检查 3306 端口是否被其他程序占用：
在 Linux 中：
sudo netstat -tuln | grep 3306
在 Windows 中，你可以使用：
netstat -ano | findstr :3306
如果发现有其他程序正在使用该端口，可以尝试停止该程序或更改 MySQL 的配置，让其使用不同的端口。
3. 代码示例
以下是用 PHP 连接 MySQL 数据库的示例代码：
<?php
$servername = "localhost";
$username = "your_username";
$password = "your_password";
$dbname = "your_database";
// 创建连接
$conn = new mysqli($servername, $username, $password, $dbname);
// 检测连接
if ($conn->connect_error) {
die("连接失败: " . $conn->connect_error);
}
echo "连接成功";
?>
通过这段代码，你可以测试 MySQL 连接是否成功。如果控制台显示“连接成功”，说明连接正常；如果出现相关错误，则需根据错误信息逐步排查。
结论
解决“2002 - Can't connect to server on 'localhost' (10061)”错误，通常需要检查 MySQL 服务状态、配置、网络安全设置及端口占用情况。通过上述步骤，你应该能够有效地诊断并解决这个问题，从而顺利连接 MySQL 数据库。若问题仍未解决，建议查阅 MySQL 的官方文档或相关社区以获取更多帮助。
