文章资讯 / 常见问题 / 数据库连不上?四类原因按顺序排查

数据库连不上?四类原因按顺序排查

发布时间: 分类:常见问题 作者:188mi 来源:php.cn,help.aliyun.com,comate.baidu.com,blog.csdn.net 阅读:3
网站突然报错「Database connection failed」——用户看不到页面,你心跳加速。数据库连接失败是运维最高频的故障之一——原因从服务未启动到SSL不兼容多达十几种。这篇按四层排查路径讲清楚,十分钟内定位问题。

第一层:MySQL服务本身活着吗排查的起点——确认数据库服务是否在运行。命令:systemctl status mysql或systemctl status mysqld——看active (running)还是inactive/failed。如果服务没跑:启动它——systemctl start mysql。如果启动失败:看错误日志——tail -50 /var/log/mysql/error.log——常见原因包括端口被占用、配置文件语法错误、磁盘空间不足。另一个容易忽略的原因:bind_address配置——MySQL默认绑定127.0.0.1只允许本地连接——如果应用服务器不是本机,需要在my.cnf中改成bind_address = 0.0.0.0或指定内网IP。

第二层:网络通不通服务在跑但连不上——检查网络层。从应用服务器测试到数据库服务器的连通性:telnet数据库IP 3306——能连说明端口通;Connection refused说明端口未开放或服务绑定地址不对;超时说明防火墙拦截或网络不通。云服务器的特殊注意:安全组要放行3306端口——很多「本地能连但应用连不上」的问题,最后发现是云安全组没放行。自建防火墙也要检查——firewalld或iptables是否放行了3306。网络层排查的完整链条:应用服务器→中间网络(防火墙/安全组)→数据库服务器(iptables+bind_address)→MySQL端口。

第三层:用户权限给对了吗网络通了但认证失败——Access denied for user。MySQL的权限系统:用户名@主机——'user'@'host'的三元组必须完全匹配。常见错误:你在数据库服务器上用localhost能连,但应用服务器用IP连不上——因为MySQL里只给了'root'@'localhost'的权限——需要新建或修改用户授权为'root'@'应用服务器IP'或'root'@'%'(任意主机,安全性较低)。排查命令:在MySQL命令行中执行SELECT user, host FROM mysql.user——看你的用户对应哪些host。另一个常见坑:密码过期——MySQL 8.0+默认密码有过期策略——ALTER USER 'user'@'host' IDENTIFIED BY 'new_password'重置。还有一个少见但坑人的:密码中的特殊字符——连接字符串里$、@等字符没有转义——应用连接时密码传错了。

第四层:SSL和版本兼容前三层都排除了还连不上——检查高级配置。SSL问题:MySQL 8.0+默认强制SSL连接——如果应用端不支持SSL或不匹配TLS版本,会报SSL connection error。解决:在连接参数中显式指定——useSSL=false(关闭)或配置正确的SSL证书。版本兼容问题:MySQL 8.0的默认认证插件从mysql_native_password换成了caching_sha2_password——老版本的PHP或客户端可能不支持。解决:ALTER USER 'user'@'host' IDENTIFIED WITH mysql_native_password BY 'password'——切回老认证方式。连接数耗尽:MySQL的max_connections满了——新连接被拒绝——show processlist看当前连接数,kill掉空闲连接或调大max_connections。

一张排查速查卡Connection refused→服务没跑或端口没开→查systemctl和bind_address。Access denied→权限或密码问题→查user@host授权和密码过期。Connection timed out→防火墙或网络不通→查安全组和iptables。SSL error→MySQL 8.0的SSL强制→加useSSL=false或配证书。server has gone away→连接超时或被杀→查wait_timeout和max_allowed_packet。Unknown database→数据库名拼错或未创建→查SHOW DATABASES。六种常见报错对应的排查方向——按卡索骥,十分钟内定位。

写在最后数据库连接失败的四层排查(服务→网络→权限→SSL)覆盖了绝大多数场景——每层排查一到两分钟,四层走完十分钟。把这张速查卡存在手机里——按层走就对了。