连接本地和服务器 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 端口被其他程序占用。
-
服务器上的某些网络设置或安全策略限制了连接。
文章目录
- 一、错误原因分析
- 作者简介
- 猫头虎是谁？
- 作者名片 ✍️
- 加入我们AI共创团队 🌐
- 加入猫头虎的共创圈，一起探索编程世界的无限可能！ 🚀
- 正文
- 二、MySQL 版本分析
- 1. MySQL 5.7
- 解决方案：
- 解决方案权重：🌟🌟🌟
- 2. MySQL 8
- 解决方案：
- 解决方案权重：🌟🌟🌟🌟
- 三、操作系统分析（详细版）
- 1. Windows 10
- 解决方案：
- 解决方案权重：🌟🌟🌟
- 2. Windows 11
- 解决方案：
- 解决方案权重：🌟🌟
- 3. Linux（例如 Ubuntu）
- 解决方案：
- 解决方案权重：🌟🌟🌟🌟🌟
- 4. macOS
- 解决方案：
- 解决方案权重：🌟🌟🌟
- 5. Ubuntu（详细版）
- 解决方案：
- 解决方案权重：🌟🌟🌟🌟
- 总结
- 粉丝福利
- 联系我与版权声明 📩
作者简介
猫头虎是谁？
大家好，我是 猫头虎，猫头虎技术团队创始人，也被大家称为猫哥。我目前是COC北京城市开发者社区主理人、COC西安城市开发者社区主理人，以及云原生开发者社区主理人，在多个技术领域如云原生、前端、后端、运维和AI都具备丰富经验。
我的博客内容涵盖广泛，主要分享技术教程、Bug解决方案、开发工具使用方法、前沿科技资讯、产品评测、产品使用体验，以及产品优缺点分析、横向对比、技术沙龙参会体验等。我的分享聚焦于云服务产品评测、AI产品对比、开发板性能测试和技术报告。
目前，我活跃在CSDN、51CTO、腾讯云、阿里云开发者社区、知乎、微信公众号、视频号、抖音、B站、小红书等平台，全网粉丝已超过30万。我所有平台的IP名称统一为猫头虎或猫头虎技术团队。
我希望通过我的分享，帮助大家更好地掌握和使用各种技术产品，提升开发效率与体验。
作者名片 ✍️
- 博主：猫头虎
- 全网搜索关键词：猫头虎
- 作者微信号：Libin9iOak
- 作者公众号：猫头虎技术团队
- 更新日期：2025年03月21日
- 🌟 欢迎来到猫头虎的博客 — 探索技术的无限可能！
加入我们AI共创团队 🌐
- 猫头虎AI共创社群矩阵列表：
- 点我进入共创社群矩阵入口
- 点我进入新矩阵备用链接入口
加入猫头虎的共创圈，一起探索编程世界的无限可能！ 🚀
部分专栏链接：
🔗 精选专栏：
- 《面试题大全》 — 面试准备的宝典！
- 《IDEA开发秘籍》 — 提升你的IDEA技能！
- 《100天精通鸿蒙》 — 从Web/安卓到鸿蒙大师！
- 《100天精通Golang（基础入门篇）》 — 踏入Go语言世界的第一步！
正文
二、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 端口的流量：
- 打开控制面板 -> 系统和安全 -> Windows 防火墙 -> 高级设置 -> 入站规则。
- 新建入站规则，选择端口，指定端口号
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:ProgramDataMySQLMySQL Server 8.0data目录下。
解决方案权重：🌟🌟
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 错误的关键所在，确保服务正常启动、配置文件正确、网络和防火墙设置得当是解决问题的主要步骤。希望这部分内容能帮助大家在不同的操作系统环境下高效解决问题。
粉丝福利
👉 更多信息：有任何疑问或者需要进一步探讨的内容，欢迎点击文末名片获取更多信息。我是猫头虎博主，期待与您的交流！ 🦉💬
联系我与版权声明 📩
- 联系方式：
- 微信: Libin9iOak
- 公众号: 猫头虎技术团队
- 版权声明：
本文为原创文章，版权归作者所有。未经许可，禁止转载。更多内容请访问猫头虎的博客首页。
点击✨⬇️下方名片⬇️✨，加入猫头虎AI共创社群矩阵。一起探索科技的未来，共同成长。🚀
本文地址：https://www.vps345.com/380.html
