在 10 分钟内修复 WordPress“建立数据库连接时出错”

WordPress 是最流行的内容管理系统之一,它从强大的数据库中存储和收集数据。 您在 WordPress 网站上查看的页面、帖子、数据或任何信息都是从数据库中检索的。

但有时,会出现可怕的“建立数据库连接错误”。 幸运的是,这个错误可以通过几个简单的步骤来解决。

但是,错误消息可能是由于服务器配置不良、数据库连接或凭据错误造成的。 该消息表明 WordPress 无法连接到其数据库。 因此,它无法检索正确显示您的网站所需的基本数据

遇到这个错误确实令人沮丧,但这是 WordPress 用户面临的常见错误。 在本文中,我们将解释“建立数据库连接时出错”的原因。

然后,我们将提供故障排除步骤来解决问题并在 10 分钟内恢复您网站的功能。

WordPress 建立数据库连接错误的根本原因

通过确定“建立数据库连接时出错”的根本原因,您可以采取深入的故障排除策略。 以下是错误背后的一些典型原因:

错误的数据库凭证

此错误背后的主要原因之一是 WordPress 配置文件 (wp-config.php) 中提供的数据库凭据不正确。 其中包含主机信息、数据库用户名、密码和数据库名称。 因此,如果这些凭据有任何不一致,WordPress 将不会连接到数据库。

数据库损坏或损坏

连接问题可能是由于数据库损坏或损坏造成的。 软件不兼容、升级不充分或数据库管理不正确都可能是造成这种情况的原因。 在某些情况下,WordPress 会出现连接问题并显示错误消息。

服务器或托管限制

服务器或托管环境的问题通常会导致数据库连接问题。 这可能是由于服务器拥挤、资源缺乏或短暂停机造成的。 由于内存分配有限或严格的防火墙规定,WordPress 也可能无法建立到数据库的链接。

数据库服务器不可用

当数据库服务器关闭或出现连接问题时,WordPress 将无法连接到数据库服务器。 这通常是由网络问题、数据库服务器技术困难或服务器维护问题引起的。

冲突的插件或主题

有时,插件或主题之间的冲突可能会阻碍 WordPress 数据库连接。 不兼容或开发不良的插件或主题可能会同时尝试访问数据库。 因此,与数据库发生冲突,导致“建立数据库连接错误”。

超出数据库存储配额

如果您超出了托管计划分配的数据库存储配额,则会显示数据库连接错误。 当许多网站在共享托管计划下共享给定的数据库容量时,这种情况经常发生。

  如何在 Safari 中更改我的默认主页

现在您已经知道了错误背后的原因,是时候了解我们如何解决它了。

探索以下有效的解决方案来解决 WordPress 中的“建立数据库连接错误”错误。 在继续进行任何故障排除之前,创建网站备份至关重要,以防止出现任何不可预见的问题。 如果出现复杂情况,备份可以让您将站点恢复到之前的状态。

验证数据库登录凭据

提供不正确的 WordPress 数据库登录凭据是 WordPress 中数据库连接问题的最常见原因。 这通常发生在将您的 WordPress 网站切换到不同的托管公司之后。 但是,您可以按照以下步骤解决该问题:

#1. 找到 wp-config.php 文件

您将在 wp-config.php 文件中获取 WordPress 数据库凭据。 该文件作为 WordPress 的配置文件,包含数据库的基本设置,包括数据库信息。 您可以使用 FTP 客户端或登录 cPanel 访问此文件。

#2. 编辑 wp-config.php 文件

编辑 wp-config 文件是检查和编辑数据库凭据的关键步骤。 通过此文件,您还可以看到其他 WordPress 错误,例如内存限制错误、白屏死机错误、目录中没有此类文件错误等。

#3。 识别相关线路

现在,查看以下包含 MySQL 设置和数据库信息的行。

// ** 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' );

#4。 验证数据库凭据

确保 wp-config.php 文件中提供的数据库名称、用户名、密码和数据库主机信息准确无误。

#5。 确认数据库详细信息

只需登录您的 WordPress 托管帐户并转到数据库区域即可。 然后检查 MySQL 数据库或类似的选项,因为它可能会根据您的托管提供商的 cPanel 的不同而有所不同。

#6。 访问数据库信息

在托管帐户仪表板的数据库管理页面上识别数据库名称以及用户名,以访问数据库信息。 记下此数据,因为下一步操作需要它。

#7. 如果需要,更改 wp-config.php 文件

如果您发现 wp-config.php 文件中的数据库信息与您的托管帐户中的数据库信息相比有任何差异,请对 wp-config.php 文件进行必要的更改。 检查“DB_NAME”、“DB_USER”、“DB_PASSWORD”和“DB_HOST”的设置是否与正确的数据库信息相对应。

#8。 运行连接测试

保存 wp-config.php 文件的修改后重新访问您的网站。 验证数据库连接问题现已修复。 如果问题仍然存在,请继续执行以下故障排除过程。

  每个 iPad 用户都应该知道的 20 个键盘快捷键

修复 WordPress 数据库

错误消息“一个或多个数据库表不可用”表示您的数据库需要修复。 在这种情况下,您可以按照以下流程修复数据库:

访问并编辑 wp-config.php 文件:

正如我们之前提到的,wp-config.php 文件包含数据库信息和凭据等关键设置。 首先,您需要使用文本编辑器找到并访问该文件。 然后,只需在“就这样,停止编辑!”行之前添加以下行: 快乐写博客!”

define('WP_ALLOW_REPAIR', true);

现在,应用更改后保存 wp-config.php 文件。

访问修复页面:转到您的网络浏览器并访问以下 URL,但不要使用“yoursite.com”,而是使用您的实际域名:

http://www.yoursite.com/wp-admin/maint/repair.php

修复数据库:您现在已转到 WordPress 数据库修复和增强页面。 请记住,您无需登录即可访问此页面。 在此阶段,只需按照页面上给出的说明进行操作并优化您的数据库即可。

消除代码:正确修复和优化数据库后,从 wp-config.php 文件中删除额外的行至关重要。 因此,通过注释删除以下行:

// 定义(‘WP_ALLOW_REPAIR’, true);

确保数据库服务器可用性

当 MySQL 服务器离线时,您的 WordPress 网站可能会显示“建立数据库连接时出错”警告。 当连接数超出服务器允许的数量时,通常会出现此问题。

当 MySQL 服务器离线时,您的 WordPress 网站可能会显示“建立数据库连接时出错”警告。 当连接数超出服务器允许的数量时,通常会出现此问题。

建议您与您的房东联系,以确定并解决此问题。 告诉他们问题并要求他们检查 MySQL 服务器的状况。

#1. 检查MySQL连接权限

如果您使用单站点托管,请确保 WordPress 数据库用户具有连接 MySQL 的正确访问权限。 制作 PHP 文件和检查连接是执行此操作的两种方法。

  • 访问主机控制面板:登录并转到 WordPress 网站的 public_html 文件夹,进入主机控制面板。

  • 创建新的 PHP 文件:在 public_html 文件夹中,创建新的 PHP 文件。 您可以为其指定任何名称,例如“test.php”。

  • 插入代码:将以下代码放入您的 PHP 文件中。
 <?php
$link = mysqli_connect('localhost', 'username', 'password');
if (!$link) {
   die('Could not connect: ' . mysqli_error());
}
echo 'Connected successfully';
mysqli_close($link);
?>
  • 更新凭据:将“用户名”和“密码”替换为您实际的 MYSQL 数据库用户名和密码。
  • 保存并访问文件:保存文件并通过访问相关 URL(例如,http://www.yoursite.com/test.php)在 Web 浏览器中打开它。

#2. 确认连接成功

一旦 PHP 文件连接到 MySQL 服务器并显示“连接成功”消息,您的用户可能拥有必要的权限。 这表明“建立数据库连接时出错”警告可能是由其他来源引起的。

#3。 优化服务器资源

资源限制最终可能会导致共享服务器上托管的网站出现数据库问题。 因此,您可以考虑使用带有 W3 Total Cache 或 WP Rocket 等插件的网站缓存来缓解这一问题。 这些缓存插件可以提高速度,同时减少服务器的负载。

解决主题和插件问题

文件损坏也可能是 WordPress 网站出现“建立数据库连接错误”的原因。 您可以遵循以下流程来解决此问题

#1. 识别有问题的主题或插件

实际上,有缺陷的主题和插件通常是文件损坏的原因。 独立检查每个主题和插件,看看哪一个是造成错误的原因。 当激活新主题后出现问题时,问题是由该主题引起的。

#2. 改变主题

要解决此问题,请登录 WordPress 仪表板并转到“外观”>“主题”。 然后通过选择并激活不同的主题来更改当前主题。

  如何在线查看未发送消息

#3。 更改损坏的插件

如果更改主题无法解决“建立数据库连接时出错”问题,请查找任何潜在的插件损坏。 要找到损坏的插件,请禁用所有插件,然后一次重新激活它们。

#4。 通过主机控制面板禁用插件

您还可以在主机控制面板中重命名插件文件夹以禁用每个 WordPress 插件。 要从 cPanel 禁用插件,请按照下列步骤操作:

  • 登录到您的 cPanel 仪表板并导航到“文件管理器”选项。
  • 转到 public_html > wp_content 并找到插件文件夹。
  • 右键单击插件文件夹,然后选择“重命名”。 现在只需提供一个新名称即可。

#5。 验证影响

如果重命名插件文件夹,所有插件将立即被禁用。 您可以按照相同的步骤禁用网站上的所有 WordPress 主题。 不要同时停用插件和主题,因为这会使调试变得更加困难。

#6。 恢复 Pluigns 文件夹

现在,访问站点后端后,将插件的文件夹重命名回原来的名称。 您将能够从管理区域手动激活每个 WordPress 插件,因为所有插件都将保持不活动状态。

#7. 删除有问题的主题或插件

为了避免出现“建立数据库连接时出错”问题,请不要忘记删除导致该问题的特定 WordPress 主题或插件。

建立新数据库

如果您仍然无法修复“建立数据库连接时出错”问题,您的数据库可能已完全损坏。 在这种情况下,创建一个新的 MySQL 数据库是最好的主意。 因此,继续执行以下使用 cPanel 创建新 MySQL 数据库的过程:

访问 MySQL 数据库:首先,登录 cPanel,转到数据库并单击 MySQL 数据库。

创建新数据库:找到页面顶部的“创建新数据库”部分以开始创建新数据库。 输入所选数据库名称后,单击“创建数据库”。

创建新用户:要在 MySQL 中创建新用户,请在 MySQL 用户部分输入用户名和密码。 然后单击“创建用户”继续。

分配新用户:向下滚动找到将用户添加到数据库区域。 从下拉菜单中,选择新创建的用户和数据库,然后单击“添加”。

修复损坏的数据库表:要修复损坏的数据库表,您可以使用 cPanel 或 phpMyAdmin。

  • 使用 cPanel:在 cPanel 中,您可以选择在“修改数据库”区域下检查和修复数据库。 因此,选择修复数据库来恢复损坏的表。
  • 使用 php MyAdmin:要访问 php MyAdmin,请转至数据库并单击 phpMyAdmin。 然后选择您的数据库名称并检查所有表。

  • 修复数据库表:在 phpMyAdmin 中,您需要选择位于“全部检查”按钮旁边的“修复表”选项。 因此,将执行 REPAIR_TABLE 命令来修复任何损坏的表。

耐心等待修复过程完成,然后访问您的 WordPress。 现在,检查“建立数据库连接时出错”警告是否仍然存在。 如果您的问题仍然存在,让我们尝试一下也可以解决此问题的其他方法。

更新 WordPress 网站 URL

将网站迁移到新的 Web 服务器时,您可能需要更新 WordPress URL 以指向新域。 您可以借助本分步手册来完成该过程。

访问 phpMyAdmin:登录您的托管仪表板并找到 phpMyAdmin。 使用此工具,您将可以管理网站的数据库。

打开 WordPress 数据库:在 phpMyAdmin 中,找到并选择您的 WordPress 数据库。 此步骤将授予您访问数据库表的权限。

导航到 SQL 选项卡:访问 WordPress 数据库后,找到并单击 SQL 选项卡。 在这里,您将能够执行 SQL 查询。

复制并粘贴代码:只需将以下代码复制并粘贴到 SQL 字段中:

UPDATE wp_options SET option_value = replace(option_value, 'http://www.old-domain.com', 'http://www.new-domain.com') WHERE option_name="home" OR option_name="siteurl";
UPDATE wp_posts SET guid = replace(guid, 'http://www.old-domain.com','http://www.new-domain.com');
UPDATE wp_posts SET post_content = replace(post_content, 'http://www.old-domain.com', 'http://www.new-domain.com');
UPDATE wp_postmeta SET meta_value = replace(meta_value,'http://www.old-domain.com','http://www.new-domain.com');

注意:不要忘记将“http://www.old-domain.com”替换为您以前的网站 URL,将“http://www.new-domain.com”替换为新网站 URL。

检查并执行查询:确保代码正确并使用新旧 URL 进行更新。 确认完成后,单击 Go 按钮执行 SQL 查询。

重新启动您的网络服务器

如果您使用专用服务器、本地服务器或 VPS(虚拟专用服务器),您只需重新启动服务器即可。 您的数据库相关错误以及其他错误都可以得到解决

通过重新启动 Web 和数据库服务器。 但这个过程需要 root 帐户和 SSH 客户端

恢复和备份

在某些情况下使用数据库备份和恢复过程可能是解决问题的更快方法。 许多网络托管提供自己的备份和恢复过程。 重要的是要记住数据库和文件都需要恢复。

寻求帮助

我们强烈建议您在遇到问题且无法解决时寻求专业人士的指导。 请随时联系您的托管提供商公司的客户支持服务,以进一步了解数据库连接问题,因为他们可以引导您找到适当的路线,甚至为您解决错误。

最后的话

如果您在 WordPress 网站上收到“建立数据库连接时出错”错误,请不要惊慌。 当然,您面临着失去有价值的访客的风险,但我们提出了本指南,它肯定会帮助您在几分钟内解决问题。 因此,请确定错误背后的确切原因并按照指南进行操作,以保持您的网站正常运行。

如何修复 WordPress 网站上的“406 不可接受”错误