WordPress 日志综合指南：查找、启用和修复错误

对于提供网站开发和维护服务的机构所有者来说，在客户网站上遇到错误可能具有挑战性。 错误不仅会给访问者和潜在客户留下负面印象，而且还表明存在问题。

重要的是要记住，没有软件是完美无缺的，并且可能会出现问题或错误，尤其是当 WordPress 使用各种主题和插件进行增强时。

采用最佳实践并采取积极主动的方法对于解决这些问题并确保更顺畅的运营至关重要。 监视和解决潜在站点问题的一种有效方法是维护和查看错误日志。

通过在 wp-config 文件中配置 WordPress 错误日志，机构所有者可以简化监控和诊断错误的过程，从而增强他们的网站开发和维护服务。

在本文中，我将指导您完成查找和访问 WordPress 错误日志的过程。

什么是 WordPress 日志，为什么它们对于故障排除至关重要？

错误记录涉及通过在 Web 服务器上维护简单文本文件的记录来跟踪和监控网站问题。 只要发生错误，就会更新这些文件，以便识别和分析问题。

错误日志包含错误消息，以及它们各自的发生日期和时间。 通过启用 WordPress 调试模式，这些消息将收集在一个文件中以供将来查看。

WordPress 错误日志是一种有价值的故障排除工具，有助于识别有问题的插件、主题或代码。 通过检查错误日志，您可以查明常见的 WordPress 错误，例如 WordPress 白屏死机、408 请求超时错误或 SSH 连接被拒绝错误。

现在，让我们深入研究查找和访问 WordPress 错误日志的过程。

启用 WordPress 错误日志

第一步涉及激活 WordPress 调试模式，这可以通过插件或实现特定代码来完成。

方法 1：使用插件启用 WordPress 调试模式

默认情况下，WordPress 不启用错误日志记录，因为调试已关闭。 要启动错误日志记录，第一步是安装 WordPress 调试插件，例如 WP 调试插件或任何其他最好的 WordPress 调试插件。

成功激活插件后，它会自动启用 WordPress 调试模式，允许记录和记录您网站上的错误消息，以便进行分析和故障排除。

方法 2：使用代码启用 WordPress 调试模式

如果您是高级用户，您可以通过 sFTP 访问修改 wp-config.php 文件来启用错误日志记录和 WordPress 调试模式。

但是，请注意，此方法需要谨慎，因为代码中的错误会对您的网站造成严重后果。

1. 通过 sFTP 连接到您的网站

首先，通过导航至“我的站点”→“设置”→“主机配置”在您的站点上启用 sFTP。 单击“启用 SFTP”按钮。 然后您将收到您的 sFTP 登录详细信息，包括 URL、端口号、用户名和密码。 使用 FileZilla 等 FTP 软件使用这些凭据连接到您的站点。

2. 找到并下载 wp-config.php 文件

在网站文件结构的根目录中找到 wp-config.php 文件，以及 wp-content 等文件夹。 下载此文件的副本以创建备份。

3. 编辑 wp-config.php 文件

使用记事本等文本编辑器打开 wp-config.php 文件。 寻找写着 define('WP_DEBUG', false); 的那一行并将其替换为以下代码：

 定义（'WP_DEBUG'，真）；

如果（WP_DEBUG）{

        @error_reporting(E_ALL);

        @ini_set('log_errors', true);

        @ini_set('log_errors_max_len', '0');

        定义（'WP_DEBUG_LOG'，真）；

        定义（'WP_DEBUG_DISPLAY'，假）；

        定义（'CONCATENATE_SCRIPTS'，假）;

        定义（'SAVEQUERIES'，真）；

}

通过这些更改，将启用错误日志记录和 WordPress 调试模式。 请记住仅在进行故障排除时才将此功能保持打开状态，因为保持此功能处于活动状态可能会使您的网站更容易受到黑客攻击。 要禁用错误日志记录，只需删除您添加的代码并恢复以下行：

 定义（'WP_DEBUG'，假）；

访问 WordPress 错误日志

启用 WordPress 调试模式后，您必须加载您的网站以触发任何错误代码，这些错误代码将存储在名为 debug.log 的文件中。 要通过 sFTP 访问此文件，请按照前面提到的相同步骤操作。

要找到 debug.log 文件，请导航到 wp-content 文件夹。 如果有错误，该文件将是可见的。 但是，如果没有错误，文件根本不会出现，说明一切正常。

找到 debug.log 文件后，将其下载到您的计算机。 然后您可以使用记事本等文本编辑软件打开它以查看完整的日志。 该日志将包含有价值的信息，可以帮助您或您的开发人员确定问题的根源。

分析和修复 WordPress 错误日志中发现的问题

debug.log 文件提供有关您网站上的错误和警告的宝贵信息，但不能直接编辑。 相反，您应该使用它作为参考来识别您的站点、主题、插件或代码的问题。

要使用 debug.log 文件，请执行以下步骤：

• 识别调试日志中的错误或警告。
• 记下与条目关联的错误代码。
• 查看错误代码的含义以了解具体问题。
• 请参阅单独的指南或资源以找到修复该特定错误的解决方案。

检查 debug.log 文件时，每个条目通常包括日期、时间、模块、进程 ID 和访问者的 IP 地址。 但是，最重要的部分是错误消息本身。 例如，您可能会遇到“找不到文件”之类的错误，表示缺少文件并提供其路径。

一旦了解了错误的原因，就可以继续修复它。 常见的解决方案包括更新指向已移动或删除的文件的链接。

有时，您可能会遇到通知错误（例如，“检测到虚拟主机的机器人”），这表明服务器关闭了连接。 调试日志应提供有关连接终止原因的更多详细信息，例如检测到潜在的有害机器人。

请记住，debug.log 文件主要用于故障排除目的，不应直接修改。 它是诊断和解决网站问题的宝贵工具。

使用错误日志识别和解决与性能相关的问题

人们可能会遇到多种类型的 WordPress 错误日志，试图在此处列出所有错误日志将导致进行广泛而详尽的编译。

但是，我们仍然可以通过一个示例来了解如何查看错误日志来识别和解决与性能相关的问题。

例如，权限错误...

错误日志中的权限错误会触发 PHP 警告。 当以不正确的权限访问文件时，会发生此类错误。

一种常见的情况是，当文件通过 SFTP 上传时，没有通过 wp-admin 仪表板重置权限，导致权限设置不正确。 验证错误中提到的文件是否存在很重要。

示例 1：

 PHP 警告：由于权限被拒绝，无法打开流以写入文件“/path/to/yourblog/wp-content/themes/badperms/lib/css/theme.css”。 此错误源于文件“/path/to/yourblog/wp-content/themes/WFTDAtv/lib/less/lessc.inc.php”第 1418 行...

示例 2：

 [2023 年 5 月 31 日星期六 21:30:22] [错误] [客户端 127.0.0.1] PHP 警告：无法打开流以写入文件“/path/to/yourblog/wp-content/themes/yoo_phoenix_wp/缓存/xml-80a72b04a693554d055946d5ad954588.php”由于权限被拒绝。 此错误发生在第 34 行的文件“/path/to/yourblog/wp-content/themes/yoo_regvis_wp/warp/helpers/xml.php”中。参考页面：http://example.com/wp-admin/customize .php

在某些情况下，此类错误可能表明插件或主题正在尝试执行不允许的操作或试图访问它不应访问的文件或目录。

示例 3：

 PHP 警告：由于权限被拒绝，无法打开流以写入文件“/path/to/yourblog/wp-content/cache/autoptimize/autoptimize_f7d7e4c8e9a3146b6b514d7e7f9e2468.php”。 此错误源自第 22 行的文件“/path/to/yourblog/wp-content/plugins/plugin_folder/plugin_file.php”...

利用 SafeUpdates 增强开发工作流程

作为机构所有者，您可能要为客户负责许多任务，从开发和增强到定期更新。

仅仅更新一个 WordPress 网站，平均而言，代理机构可能会花费几个小时到几天的时间来更新客户站点。

但是，如果您可以自动执行某些任务以节省时间和资源呢？

如果您厌倦了在更新 WordPress 网站上的插件或主题时遇到诸如“500 Internal Server”或“503 Service Temporarily Unavailable”之类的令人困惑的错误，Cloudways 可以为您提供帮助！

Cloudways 的 SafeUpdates for WordPress 是一个可选的附加组件，旨在简化在您的 WordPress 站点上检测、测试和部署核心、主题和插件更新的过程。 无论您是忙碌的 Web 创建者还是企业主，SafeUpdates 只需点击几下即可自动执行这些任务。

SafeUpdates 提供灵活的更新选项，允许您立即执行更新或安排稍后更新，所有这些都在用户友好的 Cloudways 管理平台中完成。 凭借其自动化工作流程，SafeUpdates 可确保高效且自信的更新计划，让您腾出时间处理更重要的业务任务。

利用 SafeUpdates 的自动化测试功能

对于负责管理客户站点的开发人员和机构而言，SafeUpdates 的自动测试功能是游戏规则的改变者。 它消除了更新 WordPress 网站的麻烦。

当检测到更新（核心、主题和插件）时，SafeUpdates 会自动触发一系列操作来启动更新过程。 它首先进行全新备份，这在处理客户站点以确保数据完整性并提供安全网以防出现任何问题时至关重要。

在部署更新之前，SafeUpdates 会创建一个临时暂存环境，在其中进行全面测试。 这些测试涵盖关键方面，例如视觉回归、性能、日志和 HTML 检查。

通过在受控环境中全面评估更新，您可以在任何潜在问题影响实时站点之前识别并解决它们。

一旦更新通过测试阶段，SafeUpdates 就会智能地处理部署。 它会自动将更新部署到实时站点，确保您的客户受益于最新的功能、安全增强和错误修复。 如果在测试阶段出现任何问题，SafeUpdates 会立即回滚更新，防止中断并维护站点的稳定性。

作为开发人员或代理机构，自动化更新过程并进行全面测试可以节省您的时间并降低出错或兼容性问题的风险。 SafeUpdates 让您在整个过程中随时了解情况，提供更新和更新状态通知。 这种透明度使您能够掌握更新过程并让您的客户了解情况。

它是一种非常有用的工具，可以简化您的工作流程、最大限度地降低风险并使您客户的网站保持顺畅运行。

最后的想法

在您的网站上启用错误日志对于有效的故障排除和保持可靠的在线状态至关重要。 它使您能够快速识别和解决错误，保护您网站的声誉和访问者体验。 此外，备份和暂存环境提供了额外的保护层。

为了进一步增强您的工作流程并节省时间，Cloudways 提供了 SafeUpdates。 这个强大的解决方案可以自动对 WordPress 网站进行安全更新，无需手动干预。

借助 SafeUpdates，您可以确保您的插件、主题和核心软件始终处于最新状态，从而提高安全性和性能。 通过 Cloudways 的 SafeUpdates 简化您的更新过程并最大限度地提高效率，并将您的站点管理提升到一个新的水平。