一、数据库服务未运行
数据库服务未启动是最常见的连接失败原因。通过宝塔面板的「数据库」模块检查MySQL/MariaDB运行状态,若服务未启动需查看错误日志定位问题。常见日志路径包括/var/log/mysqld.log
,日志可能显示磁盘空间不足、配置文件错误或端口冲突等信息。
二、防火墙/端口限制
网络层面的限制包含以下可能性:
- 服务器防火墙未开放3306端口
- 云服务商安全组策略限制
- 本地防火墙软件拦截连接
建议在宝塔「安全」模块检查端口放行情况,同时登录云服务器控制台确认安全组规则。
三、用户权限配置
权限问题通常表现为:
- 数据库用户未授权远程访问权限
- 访问IP地址未加入白名单
- 密码修改后未同步更新配置
通过phpMyAdmin执行GRANT
语句重新授权,或使用宝塔的数据库权限管理功能重置访问权限。
四、配置文件错误
配置文件my.cnf
的错误修改会导致服务异常:
- 绑定地址设置为127.0.0.1限制远程访问
- 内存参数设置超出服务器实际资源
- 日志文件路径权限配置不当
建议通过宝塔「配置文件」功能恢复默认设置后逐步调整。
五、资源限制问题
系统资源不足会导致数据库拒绝连接:
- 磁盘空间使用率超过95%
- 内存耗尽触发OOM Killer
- 进程数达到最大连接限制
通过df -h
检查磁盘空间,使用free -m
查看内存使用情况,必要时在my.cnf
中调整max_connections
参数。
数据库连接故障需遵循「服务状态→网络连通→权限验证→配置检查→资源监控」的排查流程。建议在宝塔面板启用「数据库自动备份」和「资源监控」插件,80%的连接问题可通过日志分析和配置校验快速解决。