跳到主要内容

如何排除数据库连接错误

WordPress 网站常常会遇到数据库连接错误，刚开始可能会让人感到困惑。本文概述了此错误及如何排除数据库连接问题。

我看到“建立数据库连接时出错”页面。这是什么？​

建立数据库连接时出错 数据库是使存储、组织和检索数据变得简单的软件。作为一个内容管理系统（CMS），WordPress 使用数据库来存储您所有的内容和其他网站数据。每当有人访问您的网站时，WordPress 都会连接到数据库。 “建立数据库连接时出错”在 WordPress 网站中很常见。由于它几乎不显示任何细节，可能会让人感到困惑。然而，这个问题其实很简单易懂。每当您的 WordPress 网站加载页面时，它需要访问数据库以检索显示所需的数据。简单来说，如果您的网站无法连接到其数据库，它将无法正常运行。 此问题可能由以下原因引起：

  • WordPress 设置中的数据库信息不正确
  • 数据库损坏
  • 数据库服务器无响应

有关如何定位您的 WordPress 数据库的更多信息，请访问《如何找到您的 WordPress 数据库》文章。 以下是一些常见的数据库连接错误原因及其解决方法。

  • 如何修复 WordPress 中的数据库连接错误
  • 确保您的域名连接到您数据库所在的正确服务器
  • 检查您的数据库连接信息是否正确
  • 检查您的数据库名称和数据库用户是否正确
  • 检查您的数据库密码是否与 wp-config.php 文件中的 'DB_PASSWORD' 值匹配
  • 检查您的数据库用户是否具有正确的权限
  • 检查您的数据库表前缀是否与 wp-config.php 文件中的内容匹配
  • 尝试“修复”您的数据库
  • 检查网站目录或根目录中的错误日志
  • 总结

如何修复 WordPress 中的数据库连接错误​

要解决 WordPress 中的数据库连接错误，请按照以下步骤操作。

确保您的域名连接到您数据库所在的正确服务器​

您可以使用在线可用的 DNS 查找工具，例如 LeafDNS，来检查您的 DNS 记录。 LeafDNS

检查您的数据库连接凭据是否正确​

您可能需要检查您的网站是否在 wp-config.php 文件 中使用了正确的数据库连接信息，例如数据库名称、用户名和密码。如果数据库凭据缺失、不正确或被更改，连接将失败或终止。 wp-config.php 文件

如何找到您的 wp-config.php 文件​

  1. 登录到您的 cPanel。
  2. 在 cPanel 中，查找 文件管理器，位于 文件 部分。
  3. 导航到您网站的根目录。
  4. 在目录中，右键单击 wp-config.php 文件，从选项列表中选择 编辑。您也可以点击工具栏中的 编辑 图标。
  5. 将出现一个弹出窗口。再次点击 编辑 以继续。
  6. 在脚本中，找到一行内容为 "/ WordPress 的数据库名称 /* " 的行，一旦您进入文件编辑器。
  7. 您应该能够看到您的 WordPress 网站使用的当前数据库详细信息。

请确保 wp-config.php 文件中的 'DB_HOST ' 值设置为 'localhost.' 这是必要的，因为它告诉文件在存储数据库的服务器上查找数据库。如果设置为其他值，文件将无法找到运行您网站所需的数据库。 DB_HOST - localhost

检查您的数据库名称和数据库用户是否正确​

确认您在 wp-config.php 文件中使用的数据库名称和数据库用户在 cPanel 的 MySQL® 数据库 部分存在且拼写正确。请按照《如何创建和删除 MySQL 数据库和用户》文章中的步骤确认您的数据库和数据库用户的存在。 cPanel - 数据库和数据库用户

检查您的数据库密码是否与 wp-config.php 文件中的 'DB_PASSWORD' 值匹配​

在 cPanel 的 MySQL® 数据库 部分，您可以更改数据库密码，并使用新密码更新 wp-config.php 文件中的 'DB_PASSWORD'。有关更多信息，请参考《如何重置 MySQL 数据库用户和密码》文章。 MySQL 数据库 - 更改密码

检查您的数据库用户是否具有正确的权限​

检查您的数据库在 cPanel 的 MySQL® 数据库 部分是否具有正确的用户权限。简单来说，勾选 所有权限 ，然后点击 进行更改 按钮。 有关更多信息，请访问《如何创建和删除 MySQL 数据库和用户》文章以检查您的用户权限。 MySQL 数据库 - 用户权限

检查您的数据库的表前缀是否与 wp-config.php 文件中的内容匹配​

再次检查您的 wp-config.php 文件，查找包含 "$table_prefix" 的行。该值应与您的数据库表前缀匹配。 wp-config.php 文件显示： 表前缀 在 phpMyAdmin 数据库中的样子： phpMyAdmin 表前缀

尝试“修复”您的数据库​

您可以尝试使用 MySQL 数据库的 修复数据库 功能。 在 cPanel 的 MySQL® 数据库 部分，从修改数据库的下拉菜单中选择您的数据库名称，然后点击 修复数据库。 修复数据库

修复数据库无效。我还能做什么？​

如果修复表选项无法解决问题，请尝试以下步骤。

  1. 创建一个新的数据库用户名。
  2. 为数据库分配一个新用户。
  3. 为用户分配权限。
  4. 复制 wp-config.php 文件以备份，并在新的 wp-config.php 文件中使用新的数据库用户信息更新连接字符串。

有关更多信息，请查看以下支持文章。

  • 如何创建和删除 MySQL 数据库和用户

检查网站目录或根目录中的错误日志​

名为 'error_log ' 的文件提供了有关您网站的详细信息。该文件准确显示了导致错误消息的脚本。例如，这将帮助您确定问题是由损坏的文件、插件或主题引起的。 在您的根目录中，查找名为 error_log 的文件。 错误日志 如果没有错误日志，您可能需要在 wp-config.php 文件中启用 WP_Debug。有关说明，请查看《如何启用 WP_Debug》文章。 完成后，请确保通过将 define( 'WP_DEBUG_LOG', true ); 替换为 define( 'WP_DEBUG_LOG', false ); 来关闭调试。

总结​

WordPress 数据库连接错误是一个常见问题，阻止您的网站访问其数据存储，导致故障。 要解决数据库连接错误，您可以：

  • 确保 wp-config.php 文件中的数据库名称、用户名、密码和服务器地址（通常为“localhost”）正确。
  • 确保您的数据库用户具有访问数据库所需的权限。
  • 您的网络托管提供商的 cPanel 可能有一个“修复数据库”功能来修复损坏。

对于高级用户，启用调试模式以获取更详细的错误消息，以确定确切原因（如损坏的插件、主题等）。