客户端连接mysql服务器失败怎么办？先看这三点
客户端连接mysql服务器失败，第一步不是改配置文件，而是按照“网络通不通、服务活没活、权限够不够”的顺序排查。 绝大多数情况下，问题集中在端口被防火墙拦截、mysql服务未启动或root用户只允许本地登录这三类原因上。
排查前请确认你手头有服务器的IP地址、端口号（默认3306）、用户名和密码，连最基本的连接信息都拿不准，后面的步骤全是白费。
mysql连接不上服务器怎么办：先分清楚报错类型
不同的报错信息对应完全不同的故障点,先看客户端弹出的提示：
| 报错类型 | 关键提示词 | 大概率原因 |
|---|---|---|
| 连接超时 | timeout、timed out | 防火墙拦截、IP不对、端口不通 |
| 拒绝连接 | refused、actively refused | mysql服务没启动、端口没监听 |
| 访问被拒 | access denied | 用户名密码错误、权限不够 |
| 未知数据库 | unknown database | 库名写错、大小写问题 |
如果报错信息告诉你是连接超时，重点查网络链路；如果是拒绝连接，重点查mysql服务状态；如果是access denied，重点查账号权限。
实战技巧：用telnet测试端口通不通，能直接帮你砍掉一半的排查时间。
telnet 你的服务器IP 3306
如果命令卡住不动或提示无法连接,就不用去查用户名密码了，先把网络和服务搞定。
mysql远程连接失败排查：逐层检查网络链路
第一步：确认IP地址和端口号
连接mysql不是连域名,必须写成服务器的公网IP（或内网IP）加端口号，很多用户把localhost当成服务器地址，本地没问题，远程必失败。
- 确认服务器IP有没有写错,尤其注意是公网IP还是内网IP
- 确认端口号是不是3306,有没有被改成其他端口，例如3307、3308
- 确认云厂商安全组有没有放行3306端口,别只盯着服务器防火墙
小提示：酷番云、简米云等厂商的安全组规则和服务器内部防火墙是两套独立系统，两边都得放行才管用。
第二步：检查防火墙和云安全组
Linux服务器防火墙和云厂商安全组是最容易坑人的地方,你装了mysql，服务也跑着，但别的机器就是连不上，八成是这道墙没拆。
# 检查防火墙状态 systemctl status firewalld # 永久放行3306端口 firewall-cmd --zone=public --add-port=3306/tcp --permanent firewall-cmd --reload
ubuntu系统用的是ufw,命令略有不同：
sudo ufw allow 3306/tcp sudo ufw reload
云服务器用户记得去控制台检查安全组入方向规则，需要放行TCP协议的3306端口，来源可以设置为0.0.0.0/0（全放行）或指定IP段。
第三步：查看mysql服务状态和端口监听
服务没启动或者启动失败,自然连不上，用下面几条命令查状态：
# 查看mysql服务状态 systemctl status mysqld # 或 systemctl status mysql # 查看3306端口是否在监听 netstat -tlnp | grep 3306 ss -tlnp | grep 3306
如果netstat查不到3306的监听记录,说明mysql压根没起来，重点看日志错误：
# 查看mysql错误日志，常见位置 tail -100 /var/log/mysql/error.log tail -100 /var/log/mysqld.log
本地mysql服务启动失败怎么办？多数情况下是配置文件my.cnf语法错误、数据目录权限不对或磁盘空间满了，修复后用systemctl restart mysqld重新启动，再确认端口监听状态。
mysql数据库连接被拒绝如何排查：服务状态和认证权限
检查mysql服务是否正常
服务处于active状态不代表能连上,还要确认监听的地址是不是0.0.0.0或你的服务器IP，默认配置下mysql可能只监听127.0.0.1，外部连接直接被拒。
# 查看mysql绑定的地址 netstat -tlnp | grep 3306
如果显示0.0.1:3306，说明只允许本机连接，得改配置文件，让mysql监听所有地址。
修改bind-address让远程可连
编辑mysql配置文件（常见路径为/etc/my.cnf或/etc/mysql/mysql.conf.d/mysqld.cnf）：
[mysqld] bind-address = 0.0.0.0
改完重启mysql服务,再检查端口监听：
systemctl restart mysqld netstat -tlnp | grep 3306
看到0.0.0:3306就对了，这一步是mysql远程连接失败中最容易忘记的一环，尤其新人容易踩坑。
授权root用户远程登录权限
mysql默认的root用户只允许localhost登录,想远程连接必须手动授权。
navicat连接mysql数据库失败怎么解决，一大半场景就是卡在这一步。
登录mysql执行授权命令：
-- 切换到mysql库 use mysql; -- 查看当前用户和允许的主机 SELECT user, host FROM user; -- 授权root可以从任意主机连接 ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码'; CREATE USER 'root'@'%' IDENTIFIED BY '你的密码'; GRANT ALL PRIVILEGES ON . TO 'root'@'%' WITH GRANT OPTION; FLUSH PRIVILEGES;
如果用的是MySQL 8.0以上版本，注意认证插件问题，客户端连不上的时候，可能得改一下认证方式：
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '你的密码';
测试连接并观察日志
配置完成后,在客户端机器上先用命令行测一下：
mysql -h 服务器IP -P 3306 -u root -p
如果还是连不上,去mysql服务器上开个临时日志看看具体拒绝原因：
-- 查看连接相关变量 SHOW VARIABLES LIKE 'log_error'; SHOW VARIABLES LIKE 'skip_networking';
skip_networking如果为ON，表示mysql完全关闭了网络连接功能，必须改成OFF。
云服务器部署的额外排查路径
云服务器上跑mysql,比自建机房多两道检查环节：
- 安全组规则：入方向放行3306端口，这是最容易遗漏的一步
- 系统防火墙：防火墙放行规则同样要加
内部测试没问题但外部死活连不上,优先怀疑安全组，近年来云厂商安全组配置问题导致的连接故障，在工单中占相当大比例。
本地mysql服务启动失败怎么办：检查数据目录和权限
用久了mysql的人多少遇到过这种情况：重启后服务起不来了，客户端全部提示连接失败。
常见的启动失败原因：
- 数据目录属主不对,mysql进程无法读写
- 磁盘空间满了,binlog写不进去
- 配置文件中socket路径写错
- 之前异常关机导致ibdata文件损坏
操作路径：
# 修复数据目录属主 chown -R mysql:mysql /var/lib/mysql # 检查磁盘空间 df -h # 查看具体报错 journalctl -u mysqld -n 50
业内专家指出,遇到启动失败最好先把错误日志完整读一遍，不要盲目重装数据库，否则数据丢失风险很高。
mysql端口3306被占用：换个端口或清掉占用进程
有时客户端能ping通服务器,但连接mysql时报“address already in use”，可能3306端口被其他程序占了。
# 确认占用进程 lsof -i:3306 netstat -tlnp | grep 3306
如果是另一个mysql实例占的,考虑停掉旧实例或修改新实例的端口号，改端口在配置文件的[mysqld]段加一行：
port = 3307
然后重启服务,客户端连接时把端口改成3307即可。
mysql数据库部署后远程连不上的常见认知误区
防火墙只是临时作用
有人以为用iptables临时放行就够了,服务器一重启规则就清了。务必把放行规则写入持久化配置，systemctl或firewall-cmd的永久模式。
改了配置不重启
改my.cnf后必须重启mysql进程，部分参数还要重启整个服务才能生效，确认重启过了再测连接。
安全组规则填错方向
安全组分入方向和出方向,接收外部连接要配置入方向规则，填到出方向等于白写。
Q&A：mysql连接故障的高频疑问
mysql连接不上服务器怎么办，最快定位问题的方法是什么？
用telnet命令测试IP加端口,比如telnet 123.45.67.89 3306，能通就查账号权限，不通就查防火墙和服务状态，两步定位问题范围。
mysql远程连接失败提示“Lost connection to MySQL server at ‘reading initial communication packet’”，怎么处理？
该提示通常表示网络链路中数据包被丢弃,重点检查云平台安全组是否放行3306端口，以及服务器防火墙规则，同时确认mysql配置中bind-address已设置为0.0.0.0。
navicat连接mysql数据库失败怎么解决？
先排除网络连通性,用命令行工具mysql -h IP -P 3306 -u root -p测试，确认命令行可连后，检查navicat填写的端口、用户名、密码是否和命令行一致，同时注意navicat版本对mysql 8.0 caching_sha2_password认证插件的兼容支持，必要时在mysql中改为mysql_native_password认证方式。
客户端连接mysql服务器失败,本质上就是网络链路、mysql服务、用户权限这三件事中的一件或多件出了问题，照着上面顺序逐层排查，多数情况下都能找到根因，远程连接mysql时，把bind-address、安全组端口、root权限认认真真检查一遍，比什么技巧都管用。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/%e5%ae%a2%e6%88%b7%e7%ab%af%e8%bf%9e%e6%8e%a5mysql%e5%a4%b1%e8%b4%a5%e6%80%8e%e4%b9%88%e5%8a%9e%ef%bc%8c%e8%bf%9e%e6%8e%a5%e8%a2%ab%e6%8b%92%e5%a6%82%e4%bd%95%e6%8e%92%e6%9f%a5%ef%bc%9f/
