如何调试常见的 WordPress 问题

已发表: 2023-01-25

WordPress 是一个非常稳定的 CMS 系统，在大多数情况下，可以顺利运行。但是，由于其多功能性，在某些情况下，可能会出现问题。发生这种情况的原因有多种，这就是故障排除和调试非常重要的原因。幸运的是，WordPress 附带了一个开箱即用的基本工具，可以使任务变得更加容易。

在查看许多 WordPress 管理员和网站所有者可能遇到的最常见问题之前，本文首先介绍了 WordPress 调试工具。然后，我们将查看原因并进行修复，以帮助您立即恢复正常运行。

什么是调试？

顾名思义，调试是识别错误并将其从软件代码中移除的过程。大多数（如果不是全部）软件开发人员会发现自己在调试代码——这是运行代码时的例行做法。

然而，即使代码通过了质量保证检查，新的错误也可能在软件安装后出现。

发生这种情况的原因有多种，包括软件安装在开发人员未测试的环境中。软件开发人员和测试人员不可能在所有可能的环境中测试他们的代码——永远不会发布任何软件。我们将在本文后面深入研究更多细节。

在这种情况下，网站管理员和所有者可能需要进行一些调试以帮助开发人员识别问题。虽然这听起来像是太技术性的东西，但实际上，这很容易。别着急；本文将向您展示如何操作。

什么是错误？

错误是软件中的意外行为。这种意外行为会以各种方式表现出来，包括错误、异常、警告等。它还可能导致功能和特性无法按预期工作。

发生这种情况时，我们需要调试软件，在本例中为 WordPress。幸运的是，WordPress 附带了一个开箱即用的调试工具，称为 WP_DEBUG。

WordPress 调试 – WP_DEBUG 和 WP_DEBUG_LOG

WP_DEBUG 是一个内置的 WordPress 调试工具。启用后，它会显示由 PHP 代码（支持 WordPress 的底层技术）生成的所有错误、警告和通知。

另一方面，WP_DEBUG_LOG 将这些错误、警告和通知保存到日志文件中——使其更容易与第三方共享。虽然这与 WordPress 活动日志有很大不同，但它记录了软件执行的所有操作，帮助开发人员识别代码的哪些元素正在运行。

如何使用 WP_DEBUG

WP_Debug 使用起来相当简单直接。它确实要求您具有对 WordPress 文件系统目录的 SFTP 或 SSH 访问权限，因此如果您不确定是否拥有此权限，则可能需要与您的托管服务提供商联系。

现在，该设置位于文本文件中，因此我们需要使用文本编辑器将其打开。好消息是，这是从 wp-config.php 文件完成的，该文件位于 WordPress 安装的根目录中——非常容易找到。

您要查找的设置称为 WP_DEBUG，需要将其设置为 true，如下所示：

// 启用 WP_DEBUG 模式
定义（'WP_DEBUG'，真）;

要启用日志记录，您需要启用 WP_DEBUG_LOG 选项，如下所示：

// 启用调试日志记录到 /wp-content/debug.log 文件
定义（'WP_DEBUG_LOG'，真）;

如果 WP_DEBUG_LOG 选项不可用，您可以简单地将命令复制并粘贴到 wp-config.php 文件中。

要阻止错误显示在您的 WordPress 网站前端，您可以将 WP_DEBUG_DISPLAY 选项设置为 false，如下所示；

定义（'WP_DEBUG_DISPLAY'，假）;

重要说明：WP_DEBUG 应该在您的测试或暂存环境中启用，而不是在您的实时网站上启用。

如果您正在解决特定问题，请尝试在启用 WP_DEBUG/WP_DEBUG_LOG 选项时重现该问题——具体取决于您启用的选项。这样做会导致错误，进而导致调试工具写入日志文件。

常见的 WordPress 问题

WordPress 问题

正如我们之前提到的，WordPress 是一个非常稳定的 CMS。许多开发人员在每个版本中投入了无数小时，并且许多人设法顺利运行它。知名开发商的主题和插件也是如此。然而，由于环境的变化，问题和冲突可能会出现。对于与 WordPress 相关的软件来说是这样，对于任何其他软件也是如此。因此，问题可能会不时出现。

WordPress 问题，无论是直接与 WordPress 还是主题或插件相关，并不一定意味着软件有问题。通常，这是一个配置问题。无论哪种方式，WP_Debug 都可以帮助您发现正在发生的事情。

死亡白屏

症状

白屏死机，也以其首字母缩写词 WSOD 而闻名，出现在您的 WordPress 网站中，显示一个完全空白的白屏。

原因

虽然许多因素都会导致 WSOD，但一个常见的罪魁祸首是插件和主题的兼容性问题。如果您最近安装或更新了插件，手动禁用插件或主题应该是您的第一个停靠点。

使固定

调试日志文件可以让您更好地了解是哪个插件和哪行代码导致了问题。如果您确定问题出在插件或主题上，您可能需要与开发人员联系以进行修复。如果问题出在其他地方，日志文件将使您更好地了解导致问题的原因。
数据库连接问题

症状

WordPress 数据库连接问题的发生可能有多种原因，并以不同的方式表现出来。一种更常见的症状是在您的网站上看到“建立数据库连接时出错”消息。

原因

WordPress 依靠 MySQL 来存储和读取设置和帖子等数据。如果没有连接到 WordPress 数据库，网站将无法运行。数据库连接错误的发生可能有多种原因，包括连接或凭据问题。

每当 WordPress 更新其文件、插件或主题时，它就会进入维护模式。这样做允许应用程序使文件“脱机”并更新它们。在此过程中，WordPress 会创建一个 .maintenance 文件，并将其存储在根目录中。如果出于某种原因，更新中断，WordPress 可能会陷入这种维护模式。

使固定

要使 WordPress 退出维护模式，请通过 FTP 或 SSH 登录并删除 .maintenance 文件。您可能还需要删除缓存以使网站恢复正常。 WP_DEBUG 可以帮助您解决问题，但建议您在暂存或测试环境中尝试此操作，以免网站宕机。

我的错误没有在上面列出

WordPress 环境彼此之间可能千差万别，不时会发生不明错误。在这种情况下，启用 WordPress 调试模式是您可以采取的最佳步骤之一。

虽然这听起来很吓人，但它可以帮助您更好地理解 WordPress 的工作原理，从而变得更好。请记住，拥有 WordPress 测试或暂存环境可能会有很大帮助。在不危及您的实时网站的情况下解决问题时，这样的环境非常有帮助。

WordPress 疑难解答

WordPress 依靠多种技术协同工作来确保您的网站正常运行。虽然我们对 MySQL 和 PHP 进行了相当多的介绍，但 HTML、CSS 和 Javascript 等其他技术对于网站的显示和功能至关重要。
只要您选择信誉良好的开发人员，就应该没问题，但很多时候，其他因素也会导致 WordPress 错误。这是 WordPress 调试可以证明是你的朋友的地方。说到插件和主题开发人员，这有助于确保他们提供支持，这样您就可以更轻松地休息，因为知道有人在那里可以帮助您解决问题。

故障排除是一项很好的技能，可以在无数方面为您提供帮助。您不仅可以最大限度地减少停机时间，而且在为更安全、更安全的网站进行 WordPress 安全练习时，它也会派上用场。