在WordPress中建立数据库连接时出错:最终解决方案

错误类型： 数据库错误 错误名称： 建立数据库连接时出错 英文名称： Error Establishing a Database Connection 错误描述： 数据库损坏或者登录凭据不正确，损坏的WordPress文件，数据库服务器问题和流量激增都有可能导致此错误发生。

“建立数据库连接出错”可能是WordPress用户可能遇到的最常见和最可怕的错误之一。这绝对与死亡的白屏(WSOD)有关。这个错误意味着你的网站不再通信或者不能访问WordPress数据库，整个网站都瘫痪了。

对于这样的错误，站长们不要掉以轻心，应该马上想办法解决这个问题，直接影响流量，SEO等等。不过不用担心，今天我们就来讨论一些导致这个错误的常见情况以及相应的解决方法。

建立数据库连接时，什么是错误？

导致此错误的常见情况

如何修复“建立数据库连接时出错”

建立数据库连接时，什么是错误？

WordPress网站的所有信息，如发布数据、页面数据、元信息、插件设置、登录信息等。，都存储在MySQL数据库中。唯一不存储的数据是媒体内容，如图像，以及主题/插件/核心文件，如index.php、wp-login.php等。当有人访问你的网站时，PHP会执行页面上的代码并从数据库中查询信息，然后显示在访问者的浏览器中。

如果由于某种原因这不能正常工作，那么在建立数据库连接时将会出现一个错误，如下所示。整个页面空都是白色的，因为连接没有正常工作，无法检索任何数据来呈现页面。这不仅破坏了网站的前端，也使得无法访问WordPress仪表盘。

但是，访问者可能不会立即在前端看到这个错误。这是因为在缓存过期之前，站点缓存仍然是可访问的。

建立数据库连接时出错。

当一个访问者试图访问您的网站时，会在您的日志中生成一个500 HTTP状态代码。“内部服务器错误”将以相同的状态代码出现。这意味着服务器有问题，请求的资源尚未交付。当一切正常时，你的站点会生成一个200的HTTP状态码，表示一切正常。

导致此错误的常见情况

那么究竟为什么会发生这种情况呢？嗯，这里有一些常见的原因。不要担心，我们会更深入地研究每个问题，以便您知道如何解决它们。通常，您可以在15分钟内解决此错误。

最常见的问题是数据库登录凭据不正确。WordPress网站需要使用数据库相关的登录信息来连接其对应的MySQL数据库。

数据库已损坏。因为主题的原因，可以安装和卸载的插件非常多，多年的不断删除和安装有时会导致数据库损坏。这可能是由于表丢失或个别损坏，或者某些信息被意外删除。

WordPress安装中可能有损坏的文件。有时这甚至可能是由于黑客而发生的。

数据库问题。Web端可能有几个地方出了问题，比如高峰流量导致的数据库过载或者太多并发连接导致的无响应。这在共享主机中很常见，因为它们为同一服务器上的许多用户使用相同的资源。

交通流量的激增。根据您使用的Web主机，您的服务器可能无法处理许多并发数据库连接。流量的增加可能会导致数据库暂时出现问题。

如何修复“建立数据库连接时出错”

在开始排除错误之前，建议您首先进行数据库备份，因为以下许多建议都涉及到操作数据库中的信息。无论你的技术水平如何，你都应该在试图修改WordPress网站数据库之前做好备份。

您可以使用WordPress备份插件(如VaultPress或WP Time Capsule)来备份文件和数据库。

如果你是Pagoda Panel的用户，备份你的网站文件和数据库是非常简单的。进入宝塔控制面板，在左侧菜单找到“计划任务”，进入界面，找到备份数据库和备份网站，手动执行。

备份WordPress网站

当然，也可以使用SFTP等工具访问服务器手动备份网站文件，使用phpMyAdmin手动备份MySQL数据库。备份成功后，就该开始排查“建立数据库连接出错”的问题了。

阅读:BackWPup插件备份WordPress的教程，如何安全备份WordPress博客网站数据？》

1.检查数据库登录凭据。

首先要做的是检查以确保WordPress profile的数据库登录凭证是正确的。这是迄今为止最常见的“建立数据库连接时出错”的原因，尤其是在将网站迁移到新的托管服务提供商之后。WordPress网站的连接细节存储在wp-config.php文件中，该文件通常位于WordPress网站的根目录下。

它包含四条重要的信息，所有这些信息都必须正确才能成功连接到数据库。

数据库名称

// ** MySQL settings ** // /** The name of the database for WordPress */ define(‘DB_NAME’, ‘xxxxxx’);

数据库用户名

/** MySQL database username */ define(‘DB_USER’, ‘xxxxxx’);

数据库密码

/** MySQL database password */ define(‘DB_PASSWORD’, ‘xxxxxxxxx’);

主机名(服务器)

/** MySQL hostname */ define(‘DB_HOST’, ‘localhost’);

要访问wp-config.php文件，您可以通过SFTP连接到该网站，并浏览到该网站的根目录。或者，如果您使用的是pagoda，您可以进入pagoda控制面板并单击“文件”，浏览到站点的根目录，然后右键单击以编辑文件。

宝塔文件管理

以下是打开文件后的示例。

Wp-config.php文件数据库访问凭据

现在，您需要比较当前值和服务器数据库的真实值，以确保它们是正确的。对于pagoda用户，请遵循以下说明。

检查pagoda面板中的数据库凭据。

需要登录宝塔面板，进入数据库，找到网站对应的数据库，找到数据库名称、用户名、密码等信息。

Pagoda视图数据库帐户密码

然后核对wp-config.php证件的对应信息，确保双方信息一致，非常方便。(或者说这就是为什么国内很多站长选择使用宝塔面板的原因)

在cPanel面板中检查数据库凭据。

如果您使用cPanel来管理主机，整个步骤会稍微复杂一些。

首先要检查的是数据库名称。为此，您需要进入cPanel控制面板并登录phpMyAdmin。

cPanel控制面板的PhpMyAdmin

在左侧菜单中找到与您的网站对应的数据库名称。忽略“information_schema”数据库，因为这是主机使用的数据库。然后，将该名称与wp-config.php文件中的DB_NAME值进行比较。如果它们匹配，那就不是问题。如果它们不匹配，那么您需要更新wp-config.php文件。

CPanel数据库名称

您还可以通过确保数据库包含您网站的URL来验证这是正确的数据库。只需点击数据库，然后点击wp_options表(出于安全考虑，此名称可能略有不同，如wpxx_options)。在表格的顶部，您将看到网站URL和名称的值。如果这些和你当前的站点匹配，说明这是你网站的数据库。

检查phpMyAdmin中的网站URL。

如果数据库名称是正确的，但是在建立数据库连接时仍然有错误，那么您需要检查用户名和密码。为此，您需要在WordPress网站的根目录下创建一个新的PHP文件(任意命名，例如checkdb.php)，并输入以下代码。您需要用wp-config.php文件中的值替换db_user和db_password的值。