WordPress网站遇到“数据库连接错误”报错怎么办？
当WordPress网站出现 “数据库连接错误”（Error establishing a database connection）时，通常表示网站无法与MySQL数据库正常通信。以下是详细的排查和解决方法：
| 排查步骤 | 操作说明 |
|---|---|
| 1 | 确认数据库服务是否运行：登录服务器，使用命令 systemctl status mysql 或 systemctl status mariadb 查看数据库状态，若未运行可尝试启动服务：<br> systemctl start mysql |
| 2 | 检查数据库配置文件：打开 WordPress 根目录下的 wp-config.php 文件，检查以下配置是否正确：<br> - DB_NAME（数据库名称）<br> - DB_USER（用户名）<br> - DB_PASSWORD（密码）<br> - DB_HOST（主机，默认为 localhost） |
| 3 | 手动测试数据库连接：在服务器上执行如下命令测试连接：<br> mysql -u [用户名] -p -h [主机地址]<br> 输入密码后如果无法进入数据库，说明配置或数据库服务存在问题。 |
| 4 | 检查数据库用户权限：确保数据库用户拥有对目标数据库的完整访问权限。可通过MySQL命令设置：<br> GRANT ALL PRIVILEGES ON [数据库名].* TO '[用户名]'@'localhost'; FLUSH PRIVILEGES; |
| 5 | 远程数据库需检查网络和端口：如果数据库部署在远程服务器上，请确认：<br> - 网络可达<br> - 端口3306开放<br> - 防火墙/安全组允许访问<br> - MySQL允许远程IP连接（修改bind-address或授权%） |
| 6 | 查看MySQL错误日志：日志路径一般位于 /var/log/mysql/error.log 或 /var/lib/mysql/主机名.err，可从中查找连接失败的具体原因。 |
| 7 | 重启相关服务：有时重启服务即可解决问题，执行以下命令：<br> - Web服务：systemctl restart nginx 或 systemctl restart httpd<br> - 数据库服务：systemctl restart mysql |
| 8 | 检查服务器资源使用情况：使用 top、free -m、df -h 等命令检查内存、CPU、磁盘空间是否充足，避免因资源耗尽导致连接失败。 |
其他建议：
- 开启WordPress调试模式：在
wp-config.php中设置'WP_DEBUG', true，显示更详细的错误信息。 - 定期备份数据库，防止数据损坏或丢失。
- 如果是高并发访问导致连接数过多，考虑优化SQL查询、使用缓存插件或升级服务器配置。
更新时间：2025-05-15 10:58:43