如何修复“建立数据库连接时出错”

哦，可怕的“建立数据库连接时出错”，dum，dum，dum（想象不祥的音乐播放）。 如果您是经验丰富的 WordPress 设计师或开发人员，您很可能会立即着手修复此错误。 但是对于那些不熟悉 WordPress 的人来说，这可能是一个可怕的错误消息。

当您尝试手动安装 WordPress 时，您可能会看到此错误，或者当您尝试打开您的网站或本地开发环境时，您会在浏览器的白屏上看到此错误。 后者是这个错误最可怕的版本，因为它通常会让你措手不及。

当然，任何好的托管 WordPress 主机都应该为您配置一切，并确保这些错误永远不会出现。 但是，如果您使用的是让您自己安装和管理 WordPress 的 WordPress 主机，或者如果您在本地计算机上进行开发，您可能会遇到这个问题。

在运行 WordPress 所需的所有 WordPress PHP 文件中， wp-config.php是最重要的，因为没有该文件，您的站点将无法连接到其数据库，并且您的站点将无法运行。 此文件用于定义数据库连接信息，例如数据库名称、用户名、密码和主机。 在像 Flywheel 这样的主机上，您实际上无法编辑此文件，因为它是为您配置的。 如果您使用托管主机，则可以安全地跳过下一个原因。

此错误的最常见原因

出现臭名昭著的“建立数据库连接时出错”的最常见原因是wp-config.php中的数据库连接设置不正确。 从旧托管公司迁移站点时，您必须确保更新wp-config.php文件中的数据库名称、数据库用户名和数据库密码，以反映新主机上的新数据库。

不正确地移动您的 WordPress 网站

我见过的一个常见问题是，有人将他们的 WordPress 文件移动到新的托管公司，然后将域名指向新的主机，但他们没有移动他们的数据库。

让您的网站快速发展：第 2 部分

上周，我谈到了如何以前端性能为重点来加快您的网站速度。 虽然这对加快您的网站速度非常有帮助，但请不要忘记 - 还有后面...

当您转到 URL 时，该站点仍会显示，并且该站点仍将运行。 这里的问题是，当您最终取消旧主机时，网站将关闭，因为您正在连接到旧主机帐户上的数据库，从而产生“建立数据库连接时出错”错误消息。

最佳做法是将所有内容移至您的新托管公司并更新您的wp-config.php文件以反映新数据库。 这样您就可以放心地取消您的旧主机帐户，而不会丢失任何数据并看到可怕的“建立数据库连接时出错”错误。

如果您在飞轮上，他们只会为您移动所有东西，并确保您启动并运行，无需弄清楚这些配置中的任何一个。

您的wp-config.php文件是您尝试解决此问题时应该首先开始的地方。 如果您确认您的连接信息确实正确，请继续进行下面列出的这些其他修复。

发生此错误的原因可能有多种，我将带您了解一些其他情况。 不用担心 - 您无需成为开发人员向导即可修复此错误。

在尝试以下任何这些修复之前，请确保创建数据库的备份。 您可以通过您的主机控制面板转到 phpMyAdmin 然后导出 SQL 文件来执行此操作。

让我们潜入好吗？

原因 1. 更改数据库密码时忘记更新 wp-config.php 文件

更新数据库密码以使您的数据库更安全是一件非常好的事情。 强密码是最好的密码。 请记住，当您在主机控制面板中更改数据库的密码时，您还需要在wp-config.php文件中更改密码。

好消息是，这很容易解决。 您所要做的就是打开您的wp-config.php文件并添加新密码。

下载您的wp-config.php文件，打开文本编辑器，然后编辑以下行：

define('DB_PASSWORD', 'password-goes-here');

添加新密码，保存wp-config.php文件，然后通过 FTP 上传。 刷新您的网站，看看您的网站是否回来了。 如果是这样，你就完成了。 恭喜——你赢得了所有的互联网积分！

注意：确保在密码周围留下单引号，并且单引号和密码之间也不应有空格。

很容易对吧？

本质上，您所做的是确保更新您的数据库连接信息以反映新的数据库密码。

再一次，如果您使用的是像 Flywheel 这样的主机，则此步骤不适用于您，您可以安全地继续前进！

原因 2. 在著名的 WordPress “5 分钟安装”过程中，您输入了错误的数据库信息

在线工作时，拼写错误确实是我们生存的祸根。 一个小小的错字可能会导致网站崩溃，在这种情况下，错误的下划线或忘记数据库名称、用户名或密码中的字母或数字也会产生相同的崩溃效果。

如今，大多数 WordPress 安装都是通过您的主机控制面板使用向导来处理的，或者在托管 WordPress 上完全为您完成。 但是有些人确实喜欢手动安装。 我听说手动安装仍然是一回事。

如果您选择通过手动创建数据库并通过 FTP 手动上传 WordPress 软件的方式以 Ye Olde Fashioned 方式安装 WordPress，则需要确保在创建数据库时保存数据库用户信息。 这是复制和粘贴真正派上用场的地方。

但是，请确保在复制此信息时，您只复制您需要的文本。 您知道在数据库名称、用户名或密码之后复制一个额外的空格会被读取为字符吗？ 当安装程序尝试连接到您的数据库时，这个额外的空白字符会给您带来错误。

此外，请确保您在安装过程中在正确的字段中输入信息。 我实际上有一次脑子放屁，并意识到我在错误的字段中输入了数据库名称。 修复后，安装顺利进行！

原因 3. 将 WordPress 网站移动到新主机时，DB_HOST 可能是该主机独有的

即使您更新了wp-config.php文件以反映新托管公司的新数据库连接信息，您也可能必须更改DB_HOST字段。

这个问题比较少见，但确实会发生。 一些托管公司在wp-config中定义DB_Host参数时使用自己的唯一值，但情况并非总是如此。 其他主机实际上定义了 MySQL 数据库服务器的 URL，并且需要反映为DB_HOST的值。 一些用户也成功地使用了他们的主机 IP 地址来代替 MySQL URL 或 localhost，所以你也可以尝试一下。

如果您在飞轮上，这会自动为您处理，因此您完全不必担心。

原因 4. 您的数据库已损坏

此错误与“建立数据库连接时出错”不同，但略有相关。 有时您网站的前端工作正常，但您在后端收到诸如“一个或多个数据库表不可用，数据库可能需要修复”之类的错误。 这意味着您应该修复数据库。

这是此错误的修复：

打开您的wp-config.php文件并转到定义数据库名称、用户名、密码和主机的部分。 在主机下定义以下内容：

define('WP_ALLOW_REPAIR', true);

然后保存你的wp-config.php文件，通过 FTP 上传，然后转到这个 URL：

这将拉出一个包含两个选项的页面。 选项一是显示“修复数据库”的按钮，第二个选项是显示“修复和优化数据库”的按钮

在执行此步骤之前，我必须重申备份数据库的重要性。 即使您无法连接并不意味着您不应该有备份。

单击“修复数据库”选项，修复过程完成后打开一个新选项卡并转到您的 URL，查看“建立数据库连接时出错”消息是否消失以及您的站点是否恢复正常。

如果此修复不起作用，并且上述修复不起作用，那么您应该知道最后一个原因。

大多数托管主机每天都会为您备份您的数据，因此如果发生这种不太好的情况，有时从昨天的备份中恢复并继续移动会更容易。

原因5. MySQL数据库服务器宕机。

对于将共享主机推向极限的人来说，这往往会发生。 如果您的网站获得大量流量，这可能会使数据库服务器不堪重负。 向您致敬，因为您的网站获得了所有甜蜜的流量，但是如果您收到“建立数据库连接时出错”消息并且您已经尝试了其他修复，您可能需要升级。

在共享主机上，可以将大量网站塞进同一台服务器上。 如果一个人流量很大，或者只是一个嘈杂的邻居，那么它可能会给其他站点带来巨大的问题。 在像 Flywheel 这样的托管主机上，每个站点都有自己的服务器，所以这个问题很容易解决。

但是在直接进行托管升级之前，您应该致电您的托管公司并要求他们检查数据库服务器的状态。 也许存在技术问题，或者您的托管公司向您发送了一封有关定期服务器维护的电子邮件，而您错过了该电子邮件。 虽然您极不可能看到因服务器维护而导致的“建立数据库连接时出错”消息，但我在我的职业生涯中见过一次，无论哪种方式，都值得一通电话了解一下。

与您的托管公司交谈并解释您已经尝试了这些不同的修复方法但无济于事，并要求他们进行调查。 如果他们告诉您您的网站在服务器上产生了相当大的负载并建议进行主机升级，那么恭喜您真棒！ 请记住，这些升级意味着您的网站正在发挥作用！

总结

正如您所看到的，修复“错误建立数据库连接”错误并不像您想象的那么可怕。 只需进行一点尽职调查即可检查您是否在wp-config.php文件中定义了正确的数据库设置。 在某些情况下，需要进行更深入的挖掘才能解决问题。 归根结底，您的托管公司会为您提供支持。

了解有关飞轮的更多信息

无论您的工作环境如何，Flywheel 强大的 WordPress 平台都可以消除托管的所有麻烦，简化您的流程，并让您重新开始做最好的工作。

在这里了解更多。