出现 “Access denied for user” 和 “Can’t Connect to MySQL Server” 数据库连接错误，该如何排查？
在使用网站程序（如 Discuz!、WordPress 等）时，如果遇到如下报错：
✅ 针对
✅ 针对
Access denied for user 'xxx'@'xxx' (using password: YES/NO)Can't connect to MySQL server on 'xxx'
一、两种常见数据库连接错误对比
| 错误类型 | 报错信息示例 | 常见原因 | 解决方法 |
|---|---|---|---|
| Access denied | Access denied for user 'db_user'@'localhost' |
用户名或密码错误、用户权限不足、主机限制 | 检查数据库账号密码；确认用户是否有访问权限 |
| Can't connect to MySQL server | Can't connect to MySQL server on '127.0.0.1' |
数据库服务未运行、网络不通、端口被屏蔽 | 检查数据库是否启动；检查IP、端口是否开放；关闭防火墙测试 |
二、详细排查步骤
✅ 针对 Access denied for user 错误
- 核对数据库配置文件
- 打开网站程序的数据库配置文件（如：
config/config_global.php或.env文件）。 - 检查以下内容：
- 数据库用户名（DB_USER）
- 数据库密码（DB_PASSWORD）
- 数据库名称（DB_NAME）
- 数据库地址（DB_HOST，默认为
localhost）
- 打开网站程序的数据库配置文件（如：
- 验证数据库用户权限
- 登录 phpMyAdmin 或数据库管理面板；
- 查看该用户是否拥有对应数据库的访问权限；
- 可执行以下 SQL 授权：
sql
GRANT ALL PRIVILEGES ON 数据库名.表名 TO '用户名'@'主机名'; FLUSH PRIVILEGES;
- 尝试重置数据库密码
- 如果不确定密码是否正确，建议通过控制面板修改数据库密码；
- 修改后同步更新网站配置文件中的密码。
✅ 针对 Can't connect to MySQL server 错误
- 确认数据库服务是否运行
- SSH 登录服务器，执行命令查看 MySQL 是否运行：
bash
systemctl status mysqld - 若未运行，手动启动：
bash
systemctl start mysqld
- SSH 登录服务器，执行命令查看 MySQL 是否运行：
- 检查数据库地址和端口
- 如果使用远程数据库，请确认填写的是正确的 IP 地址；
- 默认端口为
3306，确保该端口在防火墙中开放； - 可用以下命令测试连接：
bash
telnet 数据库IP 3306
- 检查服务器防火墙设置
- 检查 iptables、firewalld 或宝塔防火墙是否阻止了 3306 端口；
- 临时关闭防火墙测试连接：
bash
systemctl stop firewalld
- 虚拟主机用户注意事项
- 部分虚拟主机不支持远程连接数据库，只能使用
localhost； - 若数据库连接地址填写为 IP，可能会导致连接失败；
- 建议直接使用
localhost作为数据库地址。
- 部分虚拟主机不支持远程连接数据库，只能使用
三、通用排查建议
| 操作 | 说明 |
|---|---|
| 清除浏览器缓存 | 避免因缓存页面导致反复报错 |
| 查看日志文件 | Discuz! 日志路径：data/log/；MySQL 日志路径：/var/log/mysql/error.log |
| 提交工单咨询服务商 | 若无法登录数据库或重启服务，请联系主机商协助处理 |
四、总结
遇到数据库连接失败问题，应根据具体报错信息进行分类排查：- 如果是
Access denied，重点检查账号密码和权限设置； - 如果是
Can't connect to MySQL server，则应从服务状态、网络连通性、防火墙策略等方面入手。
更新时间：2025-05-15 13:14:53
上一篇：Discuz! 出现 Database Error (1036)：“Table ‘common_syscache’ is read only”，如何解决？