无法连接到 localhost 上的 MySQL 服务器 (10061) 的原因及解决方法

错误代码 10061 表示客户端尝试连接到 MySQL 服务器时被拒绝。通常是因为服务器未启动、监听端口配置错误、防火墙阻止连接或权限设置不正确等原因导致。

序号	可能原因	解决方案
1	MySQL 服务未启动	检查 MySQL 服务是否正在运行，可通过服务管理工具或命令行启动服务（如 `net start mysql` 或 `systemctl start mysql`）。
2	端口未正确监听	确认 MySQL 是否在正确的端口（默认为 3306）上监听。检查配置文件 `my.cnf` 或 `my.ini` 中的 `[mysqld] port=3306` 设置。
3	防火墙阻止连接	检查系统防火墙是否允许 MySQL 端口（默认 3306）的入站和出站连接，必要时添加规则放行该端口。
4	配置文件错误	确保 MySQL 配置文件中 `bind-address` 设置为 `127.0.0.1` 或 `0.0.0.0`，以允许本地或远程连接。
5	用户权限不足	检查 MySQL 用户是否有权限从 `localhost` 连接，使用 `GRANT` 命令赋予相应权限。
6	网络问题	如果通过虚拟机或 Docker 使用 `localhost`，确认网络模式是否正确（如桥接模式或主机模式）。
7	客户端连接字符串错误	确认客户端连接字符串中的主机名、端口和用户名是否正确。

以上方法可逐一排查并解决问题。

更新时间：2025-04-12 17:07:02

我的知识记录