WordPress 用户常见的错误之一“数据库连接建立错误（Error Establishing a Database Connection）”。这个错误出现时，整个网站将无法访问。这篇文章将深入探讨这个问题的成因、排查思路、具体解决方案以及预防建议，帮助你快速恢复网站运行。
一、什么是“数据库连接建立错误”？
WordPress 是一个基于 PHP 和 MySQL 的内容管理系统（CMS）。当客户访问网站时，WordPress 会通过配置文件连接到数据库以获取页面内容、用户数据、设置等信息。如果这个过程中连接数据库失败，就会出现“Error Establishing a Database Connection”错误。
二、常见原因分析
出现这种错误由多种原因引起，常见原因包括：
数据库配置信息错误wp-config.php 文件中的数据库名称、用户名、密码或主机地址错误。
数据库服务器故障数据库服务未运行或资源占用过高导致无法响应连接请求。
MySQL 用户权限问题WordPress 连接数据库的用户权限不足。
网站被攻击或中毒被植入恶意代码导致数据库连接失败。
主机资源问题空间或流量超过限制、虚拟主机性能瓶颈等。
WordPress 核心文件损坏某些 WordPress 文件被修改或损坏，导致无法正常加载数据库功能。
三、详细排查与解决步骤
步骤 1：检查 wp-config.php 配置文件
打开网站根目录下的 wp-config.php 文件，确认以下几项设置是否正确：
define(‘DB_NAME’, ‘你的数据库名称’);
define(‘DB_USER’, ‘你的数据库用户名’);
define(‘DB_PASSWORD’, ‘你的数据库密码’);
define(‘DB_HOST’, ‘localhost’); // 通常为 localhost
如果你使用的是远程数据库或云主机（如阿里云RDS、腾讯云MySQL），DB_HOST 可能不是 localhost，需要填入数据库连接地址。
步骤 2：测试数据库连接
你可以使用一个简单的 PHP 文件测试数据库连接：
<?php
$mysqli = new mysqli(‘localhost’, ‘数据库用户名’, ‘数据库密码’, ‘数据库名称’);
if ($mysqli->connect_error) {
die(‘连接失败: ‘ . $mysqli->connect_error);
}
echo ‘数据库连接成功！’;
?>
将此文件命名为 test-db.php，上传到网站根目录，通过浏览器访问该文件（例如 https://yourdomain.com/test-db.php），查看是否能正常连接数据库。
步骤 3：重启数据库服务（VPS/独立服务器）
如果你使用的是 VPS 或独立服务器，登录 SSH 后执行以下命令重启数据库服务：
sudo systemctl restart mysql
# 或
sudo service mysql restart
步骤 4：检查数据库是否崩溃或损坏
WordPress 有内置的数据库修复功能。你可以临时修改 wp-config.php 添加以下一行：
define(‘WP_ALLOW_REPAIR’, true);
然后在浏览器访问：
http://yourdomain.com/wp-admin/maint/repair.php
根据提示修复数据库，完成后记得将上面那行代码删除。
步骤 5：联系主机商技术支持
如果你确认配置无误，数据库也没有问题，但依然报错，可以联系主机商技术支持，查看是否存在资源限制、数据库服务异常或遭到攻击。
四、防止数据库连接错误的建议
定期备份网站和数据库
使用安全插件防止攻击（如 Wordfence、iThemes Security）
为数据库用户设置最小权限原则
避免使用低质量或超负荷的共享主机
开启监控工具，实时检查数据库性能
五、总结
“数据库连接建立错误”虽然常见，但大多数情况下都可以通过系统的排查和维护迅速解决。以下是排查过程的快速清单：
检查 wp-config.php 配置
测试数据库连接
重启数据库服务
使用 WordPress 修复功能
联系主机服务商确认资源状态
掌握这些基本步骤，你就能从容应对此类数据库故障，确保网站快速恢复运行。