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

如果在安装WordPress后出现“无法建立数据库连接”的错误消息，这意味着您的网站无法连接到数据库。这是一个严重的问题，会阻止访客访问您的网站。

对于WordPress网站所有者来说，看到“无法登录WordPress：在localhost上建立数据库连接的错误”这样的消息，无疑会让人感到恐慌。当网站出现故障而下线时，我们很容易恐慌，比如出现“此账户已被暂停”的消息。

如果您遇到这个问题并无法登录WordPress，不用担心！这里有一些简单的解决方法。在本文中，您将学习如何解决WordPress网站上的“无法建立数据库连接”错误。我们还将讨论导致此错误的主要原因以及如何在将来避免它。

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

当你看到“建立数据库连接时出错（Error establishing a database connection）”时，这意味着你的WordPress网站在与其数据库沟通时遇到了麻烦。这个数据库保存了你网站的所有重要信息，比如帖子、页面、插件设置和用户信息。每当有人访问你的网站时，WordPress都会尝试连接这个数据库以获取信息。

需要说明的是，数据库并不存储你的媒体文件（比如图片和视频）或插件和主题的基本文件，比如index.php或wp-login.php。

事情是这样的：当有人访问你的页面时，PHP会运行必要的代码，从数据库中提取信息，并在浏览器中展示给访问者。

要成功连接到数据库，WordPress需要一些特定的信息，这些信息可以在wp-config.php文件中找到。如果这些信息有误，WordPress就无法建立连接，这时你在浏览器中就会看到关于数据库连接错误的通知。

你WordPress网站上的每一条内容都是存储在MySQL数据库中的，包括你的帖子、页面、布局设计、部件和主题等。所以如果你遇到这个错误，那就意味着你的网站失去了对数据库的访问，导致一切都变得空白。用户会看到一个白屏，上面写着“连接不正常”。

这其实是一种HTTP错误代码500，表示服务器接受了请求，但服务器上出现了错误。这个代码在“内部服务器错误”时也会出现。

简而言之，这意味着服务器上出现了一些问题，请求的资源未能成功交付。当一切正常时，你的网站应该会生成一个200的HTTP状态代码，这意味着“一切正常。”这个代码是在网页或资源按预期正常运作时返回的。

WordPress“建立数据库连接时出错”的原因

有几个常见原因可能导致你在WordPress网站上遇到这个错误：

WP配置中的数据库登录凭证错误

这个错误最常见的原因就是数据库登录信息不正确。记住，登录WordPress网站的凭证与数据库登录的凭证是不同的。数据库登录需要单独的强密码。如果你更改了用户名或密码，WordPress就无法再访问数据库了。

数据库损坏

如果你的数据库损坏，那绝对可能导致这个错误。很多网站都有过时的插件和主题，大家常常不记得去停用或删除它们。这些旧插件可能会造成漏洞，使得黑客更容易入侵。另外，数据库未能成功更新也可能导致问题，比如插件、主题或WordPress本身的更新失败。

WordPress安装期间存在损害的文件

有时候，WordPress安装在安装的过程中可能存在损害的文件，这些文件会干扰与数据库的连接。这些损坏的文件可能是黑客留下的后门，目的是再次获取对你网站的访问。

数据库服务器问题

你的数据库服务器可能出现了一些问题需要尽快解决。可能出现的情况包括：

数据库因流量过载而崩溃。
数据库因同时有过多连接请求而无响应。虽然这说明你的网站流量不错，但也可能造成问题。

这类问题通常在共享主机上出现，因为多个用户都在同一服务器上。

数据库表损坏

你的WordPress数据库表可能已经损坏，这也可能导致连接错误。

如何修复建立数据库连接错误？

在深入探讨如何修复这个数据库连接错误之前，最好先备份整个网站，包括数据库。每当您在WordPress网站上排除故障时，这应该成为一种习惯。

有一些插件可以自动每天备份您的网站，这样您就不必在每次更新或更改时手动设置。像UpdraftPlus这样的插件很适合备份您的文件和数据库。

故障排除步骤

检查您的数据库登录凭据

当您看到此错误的主要原因之一是数据库登录凭据不正确。这种情况通常发生在您迁移到新主机的时候。所以确保您拥有正确的凭据。

您可以在wp-config.php文件中找到WordPress网站的连接详细信息。要找到它，请执行以下操作：

进入cPanel。
打开文件管理器并导航到您的网站根目录。
右键单击wp-config.php进行编辑。

该文件包含四个重要信息：

数据库名称(DB_NAME)
登录用户名(DB_USER)
登录密码(DB_PASSWORD)
数据库主机(DB_HOST)

如果其中任何一个值不正确，WordPress将无法连接到数据库。

上述查看wp-config.php文件的方法有很多种方式，需要根据每个不同的服务提供商提供的管理面板决定。

验证数据库名称

首先，通过在cPanel仪表板中登录到phpMyAdmin检查数据库名称。点击您的数据库名称，您将看到一个表格列表。点击wp-options表旁边的浏览按钮以验证您的站点名称和URL。

如果名称与您的wp-config条目匹配，那么您就没问题。如果URL是正确的，但wp-config文件是错误的，请更新它以匹配正确的数据库名称。

验证用户名和密码

您可以通过两种方式测试您的数据库凭据：

1. 创建PHP测试文件以检查凭据是否连接到数据库。您可以使用以下示例代码：

<?php$testConnection = mysql_connect('localhost', 'root', 'password');
if (!$testConnection) {die('Error: ' . mysql_error());
}

echo 'Database connection working!';
mysql_close($testConnection);
?>

1. 保存该文件并访问其URL。在浏览器中，您将看到“成功连接”消息或“无法连接”消息。

2. 如果您找不到用户名和密码，您可能需要在wp-options表中创建一个新的。只需确保也在wp-config.php文件中更新新的凭据。

改善受损数据库

如果您仍然面临问题，您的数据库可能已损坏。这通常发生在插件添加或删除表时，导致前端显示“建立数据库连接时出错”，而后端显示“一个或多个数据库表不可用”。

WordPress有一个修复模式，您可以启用。只需将以下行添加到wp-config.php文件的底部：

define('WP_ALLOW_REPAIR', true);

然后导航到：

https://yourdomain.com/wp-admin/maint/repair.php

从那里，您可以选择修复或优化数据库。建议选择修复选项以更快的结果。请记得在执行完数据库修复后，从wp-config.php文件中删除该行。

使用phpMyAdmin修复数据库

要通过phpMyAdmin修复数据库，请执行以下操作：

登录到phpMyAdmin。
点击您的数据库并选择所有表。
从下拉菜单中点击修复表。

修复损坏的文件

导致错误的另一个原因可能是文件损坏，这可能在通过FTP传输时发生。这个问题需要迅速处理。在尝试修复之前，请务必备份数据库。

您需要执行以下操作：

1. 手动备份您的WordPress数据库。

2. 下载最新版本的WordPress并替换旧版本。

3. 删除损坏的文件，包括wp-content文件夹和wp-config-sample.php文件。

4. 使用安全的方法（如SFTP）上传更新的文件。

5. 清除浏览器缓存，检查错误是否仍然存在。

修复服务器问题

如果您尝试了所有方法但仍无效，您应该与您的托管提供商联系。问题可能出在数据库服务器本身。

如果许多用户同时访问您的数据库，可能会导致速度变慢或断开连接。为了减少与WordPress数据库的交互，考虑使用缓存插件，如W3 Total Cache、WP Super Cache或Quick Cache。

如果您使用的是共享托管计划，您可能想升级到高性能的托管服务，以便更好地处理流量并提高性能。

修复建立数据库连接时出现的错误 localhost

当你看到“建立数据库连接错误 localhost”，这表明你的网站文件无法连接到数据库。以下是解决方法：

修复步骤

1. 打开 phpMyAdmin：

访问 http://localhost/phpmyadmin。

2. 创建新数据库：

点击创建新数据库的选项，并选择一个名称。

3. 编辑 wp-config.php：

打开 WordPress 文件夹根目录中的wp-config.php 文件。

更新以下四个值以匹配你的新数据库：


/** WordPress 的数据库名称 */
define('DB_NAME', 'your_case_sensitive_database_name'); // 使用你选择的名称

/** MySQL 数据库用户名 */
define('DB_USER', 'root'); // 默认通常是 'root'

/** MySQL 数据库密码 */
define('DB_PASSWORD', ''); // 如果没有密码，留空

/** MySQL 主机名 */
define('DB_HOST', 'localhost'); // 通常是 'localhost'

4. 保存更改：

确保对wp-config.php 文件所做的更改都已保存。

5. 检查数据库登录信息：

如果在控制面板中更改了数据库登录详情，但没有在网站配置文件中更新这些信息，你的网站将无法连接到数据库。确保用户名、密码、主机名和数据库名称在wp-config.php 中设置正确。

修复 VestaCP 上的数据库连接错误

如果你在使用VestaCP的 WordPress 上遇到“建立数据库连接错误”，别担心！这里有一个简单的指南来帮助你解决这个问题。

常见原因检查

1. 数据库名称不正确

2. 数据库用户名不正确

3. 用户密码不正确

访问 wp-config.php

VestaCP 没有像 cPanel 那样的内置文件管理器，但你有几种方式可以访问网站文件：

如果你使用的是优化的 VPS，可能会有集成的文件管理器。
你也可以使用 FTP 连接，例如使用 FileZilla。
还可以使用 SSH 访问服务器。

获取访问权限后，找到并打开wp-config.php 文件以检查数据库凭据。

验证数据库凭据

在wp-config.php 文件中，你会看到类似以下内容：


/** WordPress 的数据库名称 */
define('DB_NAME', 'your_database_name');

/** MySQL 数据库用户名 */
define('DB_USER', 'your_username');

/** MySQL 数据库密码 */
define('DB_PASSWORD', 'your_password');

/** MySQL 主机名 */
define('DB_HOST', 'localhost');

与 VestaCP 设置进行比较

1. 进入 VestaCP 的数据库部分：

点击你正在使用的数据库旁边的“编辑”。在这里，你可以确认数据库名称和 MySQL 用户是否正确。

如有必要，你也可以更改用户的密码。

2. 检查服务器名称：

通常，数据库和应用程序在同一服务器上，因此正确的主机名通常是

localhost。如果不确定，请询问你的主机支持团队。

3. 用户权限：

在 VestaCP 中，你不会遇到权限问题，因为每个 MySQL 用户必须分配到一个数据库。

4. 数据库服务器响应：

如果一切都正常但仍然面临问题，请通过 SSH 登录到服务器并运行一些测试，以确保数据库服务器响应正常。

在wp-config.php 和 VestaCP 中验证并更正数据库凭据后，此时就能够解决连接错误。如果问题仍然存在，请随时联系你的主机提供商以获得进一步帮助。

如何防止未来出现数据库连接错误

为了避免你的 WordPress 网站出现数据库连接错误，可以考虑以下步骤：

最佳实践

1. 选择优质和安全的 WordPress 主机：

选择那些专门优化其平台以支持 WordPress 的主机提供商。

2. 定期备份：

每次更新网站时创建备份。

考虑使用像 UpdraftPlus 这样的备份插件，它可以自动化此过程。

3. 更新插件和主题：

确保所有插件和主题都是最新的，以确保兼容性和安全性。

4. 删除未使用的插件和主题：

删除任何不再使用的插件或主题。

定期扫描剩余的主题和插件以检查恶意软件。

5. 保持WordPress的更新：

始终使用 WordPress 的最新版本，以便享受最新的功能和安全补丁。

通过遵循这些步骤，你可以显著降低将来遇到数据库连接错误的风险。

总结

如果你在安装WordPress后看到“无法建立数据库连接”的错误，不用慌张！这错误意味着网站无法连接到数据库，可能是因为登录凭证不正确、数据库损坏或服务器问题。你可以通过检查和更新wp-config.php文件中的数据库信息，修复数据库，或联系托管提供商来解决。为了防止未来出现这些问题，记得定期备份、更新插件和主题，并选择可靠的托管服务。详细教程可以参考上面的完整步骤。