在 WordPress 中建立数据库连接的错误如何修复

前言

WordPress 中的“建立数据库连接时出错”通知是一个致命错误，它使用户无法访问您的网站。当 WordPress 无法连接到数据库时，就会发生这种情况。

由于多种因素会影响此连接，因此对于初学者来说，该错误可能有点难以排除。

在过去的 16 年里，我们一直在 WordPress 上运行我们的博客，并遇到了各种错误和警告，包括“建立数据库连接时出错”。通过我们的经验和大量的反复试验，我们学会了如何在不中断我们的网站的情况下解决这些问题。

是什么导致在 WordPress 中建立数据库连接时出错？

数据库是一种可以轻松存储、组织和检索其他软件中的数据的软件。

作为内容管理系统，WordPress 使用数据库来存储您的所有内容和其他网站数据。然后，每次有人访问您的网站时，它都会连接到数据库。

WordPress 需要以下信息才能连接到数据库：

• 您的数据库名称
• 数据库用户名和密码
• 数据库服务器

此信息存储在您的 WordPress 配置文件中，称为 wp-config.php。

这是最常见的 WordPress 错误之一。除了凭据不正确外，如果数据库服务器已关闭或数据库文件已损坏，还可能出现此错误。

话虽如此，让我们来看看如何通过分步故障排除来修复 WordPress 中的“建立数据库连接时出错”问题。

1. 检查您的 WordPress 数据库凭据
   不正确的凭据是导致数据库连接错误的最常见原因。如果您最近将 WordPress 网站移动到新主机，那么这可能是问题所在。

您的 WordPress 数据库凭据存储在 wp-config.php 文件中。它是包含重要设置（包括数据库信息）的 WordPress 配置文件。

如果您以前没有编辑过wp-config.php文件，请查看我们关于如何编辑wp-config.php文件的初学者指南以获取更多说明。

您将在wp-config.php文件中查找以下行：

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'database_name_here' );
/** MySQL database username */
define( 'DB_USER', 'username_here' );
/** MySQL database password */
define( 'DB_PASSWORD', 'password_here' );
/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

在这里，您必须确保数据库名称、用户名、密码和数据库主机的信息正确无误。

您可以从您的 WordPress 托管帐户仪表板确认此信息。在本教程中，我们将使用 Bluehost，但其他托管面板的过程也类似。

登录后，单击左栏中的“网站”选项卡，然后切换到“高级”选项卡。然后，向下滚动到“数据库”部分并单击旁边的“管理”按钮。

这将在新窗口中打开 cPanel 中的 MySQL 数据库页面。

在这里，您可以在“当前数据库”部分找到您的数据库名称和用户名。请记住将这些详细信息复制并粘贴到记事本中，以便您可以将它们添加到 wp-config 文件中。

接下来，向下滚动到“当前用户”部分，您可以在其中单击数据库名称旁边的“更改密码”链接。

这将带您进入一个新屏幕，您可以在其中根据自己的喜好更改数据库密码。

确认所有数据库详细信息后，您可以根据需要更改wp-config.php文件中的该信息。

之后，尝试再次访问您的网站，看看数据库连接错误是否消失。

如果您仍然可以看到错误，则这意味着有其他问题。

2. 检查您的数据库主机信息

如果您确信数据库名称、用户名和密码信息准确无误，那么您需要确保使用正确的数据库主机信息。

大多数 WordPress 托管公司使用 localhost 作为您的数据库主机。但是，一些托管 WordPress 托管公司使用单独的服务器来托管数据库。在这种情况下，您的数据库主机信息将不是 localhost。

这意味着您需要联系您的 WordPress 托管公司以确认这些详细信息。

3. 修复 WordPress 数据库

现在，您可能会在 wp-admin 仪表板中收到不同的错误，例如“一个或多个数据库表不可用”或“数据库可能需要修复”。在这种情况下，您需要修复数据库。

您可以通过在wp-config.php文件中添加以下行来执行此作。确保在“就这样，停止编辑！祝你写博客愉快“的台词：

	
define('WP_ALLOW_REPAIR', true);

成此作后，您可以通过访问此页面查看设置：http://www.yoursite.com/wp-admin/maint/repair.php。只需确保将 yoursite.com 替换为您自己的域名即可。

在这里，您必须单击“修复数据库”按钮以开始该过程。

但是，如果您不想向您的网站添加任何代码，那么您也可以使用托管帐户的 cPanel 修复您的数据库。

继续访问您的托管帐户，您必须从左栏中打开“网站”页面。然后，切换到“高级”选项卡并单击“数据库”部分中的“管理”按钮。

这将在新选项卡中打开 cPanel。在这里，向下滚动到“修改数据库”部分，然后从“修复数据库”下拉菜单中选择您的数据库名称。

完成此作后，只需单击“修复数据库”按钮即可开始该过程。

您现在可以访问您的 WordPress 网站以查看错误是否已解决。

4. 检查您的数据库服务器是否已关闭

如果一切似乎都正确，而 WordPress 仍然无法连接到数据库，那么您的数据库服务器（MySQL 服务器）可能已关闭。

这可能是由于服务器上的流量过大而发生的。您的主机服务器无法处理负载（尤其是当您使用共享主机时）。

因此，您的网站会变慢，甚至可能为某些用户输出错误。在这种情况下，您应该与您的托管服务提供商拨打电话或实时聊天，并询问他们您的 MySQL 服务器是否响应。

此外，如果您有其他网站在同一台服务器上运行，那么您可以检查这些网站以确认您的 SQL Server 已关闭。

如果您在同一托管帐户上没有任何其他站点，则只需转到您的托管仪表板并切换到“高级”选项卡即可。

之后，单击 phpMyAdmin 部分旁边的“管理”按钮。

这将在新窗口中打开 phpMyAdmin，您必须单击顶部的“数据库”选项。

之后，单击数据库名称以访问其设置。如果可以做到这一点，那么是时候检查数据库用户是否具有足够的权限了。

为此，您需要创建一个名为 testconnection.php 的新文件并将以下代码粘贴到其中：

<?php
$link = mysqli_connect('localhost', 'username', 'password');
if (!$link) {
die('Could not connect: ' . mysqli_error());
}
echo 'Connected successfully';
mysqli_close($link);
?>

粘贴代码后，请确保将用户名和密码替换为您自己的用户名和密码。您现在可以将此文件上传到您的网站并通过网络浏览器访问它。

如果脚本连接成功，则意味着您的用户具有足够的权限，并且是其他原因导致了错误。

现在，您必须返回 wp-config 文件并对其进行扫描，以确保所有详细信息准确且没有任何拼写错误。

对用户有用的其他解决方案
如果上述故障排除提示无法修复您网站上的数据库连接错误，那么您可以尝试这些额外的步骤。

正如我们的用户所报告的那样，这些步骤帮助他们中的一些人解决了他们网站上的数据库连接错误。

1. 更新 WordPress 网站 URL

您可以尝试在 cPanel 中使用 phpMyAdmin 更新 WordPress 网站 URL。

只需从您的托管帐户仪表板访问 phpMyAdmin 并从列表中选择您的 WordPress 数据库。

之后，切换到顶部的 SQL 菜单并输入以下 MySQL 查询：

UPDATE wp_options SET option_value='YOUR_SITE_URL' WHERE option_name='siteurl'

它应该看起来像这样：

不要忘记提供您自己的站点 URL 并更改为您自己的表名称，因为您可能已经更改了 WordPress 表前缀。wp_options

2. 重新启动 Web 服务器

专用服务器、本地服务器和虚拟专用服务器 （VPS） 上的用户可以尝试重新启动他们的服务器。

这将重新启动您的 Web 和数据库服务器，这可能会修复一些导致错误的临时故障。

结束

如果还是解决不了，那就花钱请人解决吧！其实，解决的成功率高达99%。