问题描述
当访问WordPress网站时，如果出现“建立数据库连接时出错”或“Error establishing a database connection”提示，通常意味着WordPress无法连接到MySQL数据库。这种情况可能导致网站无法正常访问，需要及时排查并修复。
常见原因
- 数据库凭据错误
wp-config.php文件中的数据库名称、用户名、密码或主机地址填写错误。
- MySQL服务未运行
- MySQL服务器可能崩溃或未启动。
- 数据库损坏或表丢失
- 数据库表可能因意外操作或服务器问题损坏。
- 服务器资源耗尽
- 内存不足、CPU占用过高或连接数超限。
- 防火墙或网络限制
- 服务器防火墙可能阻止了MySQL端口（默认3306）的连接。
解决方法
1. 检查wp-config.php配置
打开WordPress根目录下的wp-config.php文件，确认以下信息是否正确：
define('DB_NAME', '数据库名');
define('DB_USER', '用户名');
define('DB_PASSWORD', '密码');
define('DB_HOST', 'localhost'); // 也可能是IP或远程主机地址
如果修改过数据库密码，需同步更新此文件。
2. 检查MySQL服务状态
- Linux服务器：运行
systemctl status mysql或service mysql status查看MySQL是否运行。 - Windows服务器：在服务管理器中检查MySQL服务是否启动。 如果服务未运行，尝试重启：
sudo systemctl restart mysql # Linux
3. 修复数据库
如果数据库表损坏，可通过以下方式修复：
- 使用
phpMyAdmin登录，选择数据库后点击“修复表”。 - 或通过命令行修复：
mysqlcheck -u 用户名 -p --auto-repair 数据库名
4. 检查服务器资源
- 通过
htop、top或服务器面板查看CPU、内存使用情况。 - 如果资源耗尽，尝试优化数据库或升级服务器配置。
5. 排查网络与防火墙
- 确保MySQL端口（默认3306）开放：
sudo ufw allow 3306 # Ubuntu防火墙
- 如果是远程数据库，确认MySQL允许远程连接（需配置
bind-address）。
预防措施
- 定期备份数据库（可使用插件如UpdraftPlus）。
- 监控服务器资源，避免超负荷运行。
- 使用缓存插件（如WP Rocket）减少数据库查询压力。
如果以上方法仍无法解决，建议联系主机提供商或数据库管理员进一步排查。
