WordPress建立数据库连接报错如何调试

已发表: 2022-12-22

“建立数据库连接错误”无疑是WordPress用户可能面临的常见错误之一。 它与白屏死机（WSOD）密切相关。 此错误表明您的网站不再与您的 WordPress 数据库交互或无法访问。 结果，您的整个网站不可用。

此外，您应该立即解决此问题，因为它会影响您的销售、流量和分析。

本文将解释“Error Establishing a Database Connection”的含义，如何在 WordPress 中调试它，以及可能的原因。 然而，在我们开始解决这个问题的第一步之前，我们必须先了解这个数据库错误的含义。

“建立数据库连接时出错”是什么意思？

当 WordPress 无法连接到数据库时，会显示“Error Establishing a Database Connection”警告。

WordPress 最初是用 PHP 编写的，并使用 MySQL 作为其数据库系统。 当有人访问您的站点时，某些 PHP 命令将从数据库中检索信息并将其显示在访问者的浏览器上。

由于浏览器中没有可检索和显示的数据，WordPress“建立数据库连接时出错”通知将出现在空白页面上。

幸运的是，只要您网站的缓存可用，此错误通知就不会出现在前端。 但是，此数据库连接错误会阻止您访问 WordPress 仪表板。 考虑到这一点，找出导致此错误的原因并修复它很重要。

此错误的最常见原因是什么？

那么，是什么原因造成的呢？ 以下是一些常见原因。 别担心； 我们将更详细地介绍每个问题，以便您了解如何修复它们。 此问题通常会在 15 分钟内得到解决。

  • 最常见的错误是您的数据库登录凭据不正确。 您的 WordPress 站点使用不同的登录名连接到其 MySQL 数据库。
  • 您的数据库已损坏。 由于有太多带有主题和插件的移动部件，并且用户不断地删除和安装它们，数据库可能会损坏。 这可能是由于表格丢失或损坏，或者因为您不小心删除了一些信息。
  • 您的 WordPress 安装可能包含损坏的文件。 这也可能是黑客造成的。
  • 您的数据库服务器出现问题。 Web 主机端可能会出现一些问题，例如流量激增导致数据库溢出或由于并发连接过多而变得不可用。
  • 流量增加。 根据您选择的 Web 主机，您的服务器可能无法管理许多并发数据库连接。 流量增加可能会导致数据库出现暂时性问题。

如何调试“Error Establishing a Database Connection”？

在调试错误之前，我们建议对 WordPress 站点进行备份。 下面的许多建议都需要修改数据库中的数据。 因此，您不想让事情变得更糟。 无论您认为自己多么精通技术，您都应该在尝试修改 WordPress 网站之前对其进行备份。

要备份您的文件和数据库，请使用流行的 WordPress 备份插件，例如 UpdraftPlus 或 BackupBuddy。

备份完成后，就该查看数据库连接错误了。

1. 检查您的 WordPress 数据库凭据

WordPress 中数据库连接错误的最常见原因是不正确的数据库凭据。 如果您刚刚将 WordPress 站点转移到新主机，则最有可能发生这种情况。

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

在 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 作为本文的示例，但其他主机控制面板的过程类似。

转到您的托管帐户并从数据库部分选择 MySQL 数据库。

Bluehost MySQL 数据库

这会将您带到托管仪表板中的数据库管理页面。 从这里，您将看到您的数据库名称和用户名。

数据库名称和用户名

在此之下，您将看到数据库用户和更改用户密码的链接。

更改数据库用户密码

确认您的数据库名称、用户名和密码后，您可以根据需要在 wp-config.php 文件中更新该信息。

然后，返回您的网站验证数据库连接错误是否已解决。

如果您仍然可以看到错误，则说明其他地方不正确。 继续阅读以获取更多故障排除提示。

2.修复WordPress数据库

损坏的数据库是 WordPress 中“建立数据库连接时出错”的另一个原因。 这可能是由于经常安装或删除的插件或主题的数据故障导致的。

如果您的 WordPress 仪表板警告， “一个或多个数据库表不可用。 数据库可能需要修复，”您的数据库已损坏。

幸运的是，您可以通过将以下代码添加到您的 wp-config.php 文件来简单地解决这个问题：

define('WP_ALLOW_REPAIR', true);

添加代码后，在浏览器中转到http://www.example.com/wp-admin/maint/repair.php 。

从这里，您将看到两个用于修复数据库的选项； 选择最能满足您需求的那一款。

修复 WordPress 数据库的选项

修复过程完成后，检查您的 WordPress 站点，看看是否一切都恢复正常。 如果是这样，请直接转到您的 wp-config.php 文件并删除该功能。 这避免了网站滥用，因为任何人都可以在不登录的情况下查看维修页面。

3.修复损坏的文件

除了损坏的数据库之外，损坏的文件也可能是“建立数据库连接时出错”的原因。

文件损坏的原因之一是有缺陷的主题或插件。 分别检查每一个将帮助您确定问题所在。 如果在激活新主题后出现错误，则您的主题可能是问题的根源。

要解决此问题，请从 WordPress 仪表板转到外观 » 主题，然后切换到新主题。

WordPress主题

如果更改主题不能解决问题，则可能是由错误的插件引起的。 在这种情况下，请考虑停用所有插件，然后一次重新启用它们以确定原因。

或者，您可以通过在主机控制面板中重命名插件文件夹来禁用所有 WordPress 插件。

通过这样做，您的所有插件将立即被禁用。 如果重命名插件文件夹后错误消失，则表明其中一个插件是问题所在。

访问站点后端后，将插件文件夹重命名为其原始名称。 通过这样做，所有的 WordPress 插件将保持不活动状态，但您可以从管理区域一个一个地激活它们。

如果以上提示均无效，请尝试将核心文件重新上传到您的 WordPress 站点。 为此，请安装新版本的 WordPress。

下载WordPress

下载完成后，解压缩包。 从文件夹中删除wp-content 文件夹以及wp-config-sample.php文件。

删除它们后，打开一个 FTP 程序并将剩余的 WordPress 文件上传到您的根文件夹。 现在应该可以安全地替换服务器上任何损坏的文件。

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

当您的 MySQL 服务器关闭时，“建立数据库连接时出错”警告可能会显示在您的 WordPress 网站上。 虽然此错误可能由多种因素引起，但通常是连接过多。

数据库服务器一次只能连接特定数量的客户端。

当它超过该限制时，它可能无法处理更多连接。 因此，我们建议您联系您的托管服务提供商以检查您的 MySQL 服务器。

如果您在同一台服务器上托管多个站点，您还可以检查这些站点上的 MySQL 服务器是否已关闭。 同时，如果你只托管一个网站，使用PHP连接MySQL，看看你的WordPress数据库用户是否有足够的权限。

转到您的主机控制面板并打开public_html文件夹。 创建一个新的 PHP 文件并为其命名。 在此示例中，我们将调用文件 dbconnection.php。

然后将以下代码粘贴到其中：

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

请记住用您的凭据替换数据库密码和用户名。 最后，将此文件保存到您的网站并使用网络浏览器查看。

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

5. 检查你的数据库主机信息

如果您的数据库名称、用户名和密码正确，请仔细检查您使用的数据库主机信息是否正确。

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

您必须联系您的 WordPress 托管公司以检查您的数据库主机详细信息。

6.创建一个新的数据库

如果以上方法均未显示任何结果，则您的数据库可能已损坏且无法再使用。 在这种情况下，您必须使用主机控制面板来设置新的 MySQL 数据库和用户。

创建新的 MySQL 数据库后，恢复您的网站备份以避免丢失任何重要的网站数据。

结论

在 WordPress 站点上看到“Error Establishing a Database Connection”可能会令人沮丧。 该网站将无法加载，从而导致流量和客户流失。

当 WordPress 网站无法创建与服务器的连接时，会发生此数据库错误。 这可能是由不同的因素引起的，包括 wp-config.php 文件中不正确的数据库登录凭据、损坏的文件或服务器过载。

幸运的是，有几种方法可以调试此错误：

  • 检查您的数据库凭据——将 wp-config.php 文件中的数据库凭据与 MySQL 数据库中的数据库凭据相匹配。
  • 修复数据库——通过添加 define('WP_ALLOW_REPAIR', true); wp-config.php 文件中的函数。
  • 修复损坏的文件——通过您的 WordPress 仪表板停用损坏的主题或插件，或下载最新版本的 WordPress 并重新上传您的核心文件。
  • 检查你的 MySQL 服务器——用 mysqli_connect 函数创建一个新文件，看看你的数据库用户是否有足够的权限。
  • 检查数据库主机信息——仔细检查您使用的数据库主机信息是否正确。
  • 创建新数据库——从头开始创建新的 MySQL 数据库，然后导入备份。

我们希望本文能帮助您调试 WordPress 中的“Error Establishing a Database Connection”。 确定此错误的可能原因，然后按照以下步骤进行修复。

您可能还想查看我们的以下文章：

  • 如何修复 WordPress 白屏死机错误
  • 增加 WordPress PHP 内存限制（4 种方法）
  • 如何修复 WordPress 中 Facebook 不正确的缩略图问题

最后，在 Twitter 和 Facebook 上关注我们，定期更新新文章。