最后更新于 6 月 21, 2024 by 热罗姆-克维尔

您是否在 WordPress 中遇到 "建立数据库连接错误 "的问题？我将教你如何快速解决这个问题，让你的网站恢复正常运行。

有几个故障排除步骤可以有效诊断和解决此错误。按照这些步骤操作，您的网站就能恢复正常运行，而不会丢失任何内容或数据。

首先，我将解释在 WordPress 中看到 "建立数据库连接时出错 "的一些常见原因。接下来，我将指导您通过每个步骤来解决这些潜在的原因，帮助您恢复网站的功能。

在 WordPress 中建立数据库连接时出错的原因是什么？

WordPress 需要网络服务器 和数据库才能运行。网络服务器存放 PHP 文件和 WordPress 网站运行所需的其他文件，如媒体文件。数据库存放所有帖子和页面信息，以及网站配置细节。当用户浏览一个页面时、 PHP 从数据库中提取该页面的数据。如果该连接因故中断，则会出现数据库连接错误。

以下是 WordPress 中出现 "建立数据库连接错误 "的一些常见原因：

• 登录凭证不正确 - 数据库登录凭据不正确是导致数据库连接错误的最常见原因。如果您在将 WordPress 网站迁移到新主机后立即看到该消息，通常就是这个原因。
• 用户权限不足 - 您可能有正确的用户名/密码，但用户可能没有适当的权限。同样，如果您在迁移网站后遇到错误，这种情况也比较常见。
• 数据库损坏 - 这可能是直接操作 MySQL 数据库造成的，但也可能是意外造成的，例如，安装或删除一个 插头.
• 文件损坏 - 与数据库本身一样，文件损坏也会导致 WordPress 中出现 "建立数据库连接错误"。
• 数据库服务器问题 - 如果您的虚拟主机使用单独的数据库服务器，即使托管网站文件的服务器工作正常，该服务器的问题也可能触发 WordPress 中的 "建立数据库连接错误 "消息。
• 交通流量突然增加 - 流量突然激增会导致数据库错误，因为您的网站难以应付并发数据库连接的增加。如果您的网站使用的是共享主机，则更有可能出现这种情况。

同样，如果网站迁移到新主机后出现错误，前两个问题最为常见。其他问题可能发生在任何网站上。

如何修复 WordPress 中建立数据库连接时出错的问题

现在我们知道了潜在的原因，是时候解决问题了。请按照本指南逐步解决数据库连接问题，让网站重新上线。

一个好的开始是对网站进行备份。在解决问题的过程中，您不希望冒进一步损害网站的风险。备份是防止这种情况发生的明智保障。确保同时备份文件和数据库。

在 wp-config.php 中检查数据库登录凭证

您首先应该 wp-config.php 文件，该文件位于网站中名为 public_html, htdocs 或 www.使用 FTP 客户端下载。

或者，如果您的主机提供 cPanel，找到 文件管理器 图标，并导航至相应文件夹。

下载 wp-config.php 文件，并妥善保管。您需要这个版本作为备份副本。

接下来，在 wp-config.php:

// ** 数据库设置 - 您可以从虚拟主机获取此信息 ** //

/** WordPress 数据库名称 */

define( 'DB_NAME', 'database_name_here' )；

/** 数据库用户名 */

define( 'DB_USER', 'username_here' )；

/** 数据库密码 */

define( 'DB_PASSWORD', 'password_here' )；

/** 数据库主机名 */

define( 'DB_HOST', 'localhost' )；

/** 创建数据库表时使用的数据库字符集。*/

define( 'DB_CHARSET', 'utf8' )；

/** 数据库校对类型。如有疑问，请勿更改。*/

define( 'DB_COLLATE', '' )；

上例显示的是示例数据。对于列出的前四项设置（数据库名称、数据库用户名、数据库密码和数据库主机名），您应该有主机提供的信息。如果您手动安装了 WordPress，您可能自己定义了前三个凭据。

您可以通过验证数据库名称、数据库用户名、数据库密码和数据库主机名来检查信息是否正确。您可以在 数据库 部分 cPanel 如果您是 cPanel 用户。

检查数据库名称

要查看数据库名称，请访问 phpMyAdmin 并在屏幕左侧查找。它应与您的 wp-config.php.

点击数据库名称，然后点击 wp_options 表（您的表可能有不同的前缀）。查找网站 URL 和 首页 页面。这些页面应显示您网站的 URL。

检查用户名和密码

如果数据库名称无误，则可以测试数据库中的用户名和密码是否正确。 wp-config.php 通过在服务器上运行一个简单的 PHP 脚本，您就可以确保您的数据正确无误。

在记事本等文本编辑器中输入以下代码，并将其保存为 testconnect.php:

<?php

$link = mysql_connect('localhost', 'username', 'password');

if (!$link) {

die('Could not connect: ' . mysql_error());

}

echo 'Connected to database';

mysql_close($link);

?>

在脚本显示用户名和密码的地方，请用您的 wp-config.php 数据库用户和密码。

将此脚本上传到虚拟主机的 public_html, htdocs或 www 目录（具体目录取决于您的主机）。

运行脚本 yourdomainname.com/testconnect.php.如果收到成功信息，就说明用户名和密码正确无误。

如果出现错误，则需要重置数据库用户密码或创建新的数据库用户和密码。

在 cPanel 中，您可以在以下位置找到数据库用户 MySQL 数据库.

要更改数据库用户的密码，请查找 当前用户 并为要更新的用户选择 "更改密码 "选项。使用 更改密码 按钮。

或者，您也可以通过填写 添加新用户 形式

创建用户后，从下拉控件中选择用户并使用 添加.

然后你会看到一个管理用户权限的界面。检查 所有特权那么 进行更改.

记得更新 wp-config.php 并与密码和/或用户一起保存。您还可以删除 testconnect.php 您的服务器。

检查您的数据库主机名

如果在验证数据库、用户和密码后仍出现连接错误，请检查数据库主机名。数据库主机名通常是 本地主机但有些主机可能会使用 127.0.0.1.如果这两种方法都不适合您，请向您的主机查询正确的值。

检查数据库用户权限

如果验证凭据后仍收到错误信息，可以检查数据库用户的权限是否正确。如果您自己创建了数据库用户，则可能无意中赋予了他们不足的权限。

在 cPanel 中，转到 MySQL 数据库那么 当前数据库.寻找 特权用户 并点击要检查的内容。

查看检查了哪些权限，并确保 所有特权 已启用。使用 进行更改 以保存所有权限。接下来，再次尝试访问您的网站。

修复数据库

如果已经检查了数据库登录凭证和数据库用户权限，下一步就是尝试修复数据库。如果出现 "一个或多个数据库表不可用。中显示 "一个或多个数据库表不可用，可能需要修复数据库。 wp-admin.

在"...... "结尾添加以下一行，即可进入修复模式。 wp-config.php:

define('WP_ALLOW_REPAIR', true)；

编辑您的 wp-config.php 并保存，或上传更新后的 wp-config.php 文件到您的网络空间。

然后，请访问 yourdomainname.com/wp-admin/maint/repair.php.

您将获得两个选项：一个是修复数据库，另一个是修复并优化数据库。第二个选项需要更多时间。

选择您要使用的版本，完成后，再次检查"...... "是否被删除。 网站已解决连接错误.

请记住从您的 wp-config.php、 或任何人都能在您的服务器上运行修复脚本。

您也可以在 phpMyAdmin 中运行修复命令。登录并选择您的数据库；勾选 所有桌子； 并运行 维修表 中的 有选定的 下拉菜单。

最后，您可以使用 修复数据库 功能。可从 修改数据库 选项。

检查主题或插件是否损坏

如果您已损坏 主题 或插件文件，这可能是导致数据库连接错误的另一个原因。

如果无法访问phpMyAdmin，可以在phpMyAdmin中更改主题。 wp-admin.

如果这能解决你的问题，说明你的主题有问题。检查是否有能解决该错误的更新版本，或使用其他主题。

要测试故障插件，您可以在 wp-admin.如果 wp-admin 无法访问，您可以通过重命名 插件文件夹内 wp-content 通过 FTP 或文件管理器 旧插件.

现在，检查连接是否 错误已排除 如果您可以访问 wp-admin.如果是这样，就说明是某个插件出了问题。重命名 旧插件 文件夹回到 插件.然后，逐个激活插件，找出出现故障的插件。 wp-admin 并检查是否出现错误。

如果您已经检查了主题和插件，但仍遇到 WordPress 中建立数据库连接错误的问题，请继续阅读。

恢复 WordPress 核心文件

无法连接数据库的另一个可能原因是核心文件损坏。修复的方法是将 WordPress 核心文件的新副本上传到您的网站空间。

在继续操作之前，最好先进行备份。如果您对文件进行了任何更改，如 .htaccess、 您需要保留该副本，并在上传其他核心文件时使用它。

从以下网址下载最新版本的 WordPress https://wordpress.org/download/.

解压文件。然后，删除 wp-content 文件夹和 wp-config-sample.php 文件。这样就不会覆盖现有内容或创建新的 wp-config.php 锉刀

使用 FTP 将所有其他文件上传到虚拟主机，覆盖现有文件。

完成后，检查数据库连接问题是否已解决。如果没有，请继续下一步。

检查数据库服务器是否关闭

在 WordPress 中建立数据库连接时出错的另一个原因是您的数据库服务器可能无法正常工作。如果您使用的是共享主机，这种情况更有可能发生，因为共享主机会分配 每个网站的资源有限.如果您的网站人气大增，数据库服务器可能无法处理所需的更多数据库连接。

减轻数据库服务器负载的一种方法是使用缓存插件来提供静态版本的网页。这样，网络服务器就不必经常查询数据库来访问内容了。

如果您在主机上运行多个 WordPress 网站，请检查它们是否都在运行。如果其他网站都宕机了，这可能表明数据库服务器出现了问题。

您还应向托管服务提供商了解数据库服务器是否存在问题，如果存在问题，他们预计何时修复。

联系您的主机

如果一切都失败了，请联系您的主机，请他们帮助解决问题。让他们知道您已经尝试了哪些方法--他们也许能发现您遗漏的问题。

永久修复 WordPress 中建立数据库连接的错误

WordPress 中出现 "建立数据库连接时出错"（Error Establishing a Database Connection）消息时，您一定想尽快解决，因为它会破坏您的网站。幸运的是，有很多方法可以解决这个问题。

到目前为止，最有可能的原因是数据库凭据不正确--您应该首先检查这些凭据。如果不是这种情况，可以检查数据库用户权限、修复数据库、检查文件是否损坏、查看数据库服务器是否正常工作，或者向主机寻求帮助。

一旦问题得到解决，您的网站应能重新正常运行，不会出现任何数据丢失或持续问题。

更多关于以下方面的一般提示 修复 WordPress 中的问题您可能还想阅读我们的 WordPress 一般故障排除和常见错误指南。

关于修复 WordPress 网站上的 "建立数据库连接时出错 "信息，您还有什么问题吗？请在下面的评论中告诉我们！