如何设置和访问 WordPress 日志（完整指南）

网站的漏洞和故障会让你不满，并且会让你觉得网站后台存在问题。

没有任何软件是完美的。WordPress 依赖于各种主题和插件时，问题或漏洞可能会时有发生。维护和查看错误日志是监控和排查潜在网站问题的一种有效方法。

设置和访问 WordPress 错误日志有几种方法。在本文中，会告诉你们如何启用和访问 WordPress 错误日志。

什么是 WordPress 日志？它们为何对故障排查如此重要？

错误日志是通过在网站服务器上记录简单的文本文件来跟踪和监控网站问题的工具。这些文件会在发生错误时更新，从而便于识别和分析问题。

错误日志包含错误信息以及其发生的日期和时间。通过启用 WordPress 调试模式，这些错误信息会被收集到一个文件中后面方便查看。

WordPress 错误日志是一个宝贵的故障排查工具，因为它可以帮助识别有问题的插件、主题或代码。

通过查看错误日志，可以定位常见的 WordPress 错误，例如 WordPress 白屏死机、408 请求超时错误或 SSH 连接被拒绝错误。

接下来，让看看如何找到并访问 WordPress 错误日志。

如何启用 WordPress 日志？

第一步是激活 WordPress 调试模式，这可以通过插件或添加特定代码来实现。

方法 1：使用插件启用 WordPress 调试模式
默认情况下，WordPress 并未开启错误日志功能，因为调试模式是关闭的。要启用错误日志，首先需要安装一个 WordPress 调试插件，例如 WP Debugging 插件或其他调试插件。还可以用 WordPress Query Monitor 插件来调试 WordPress 网站。

成功激活插件后，它会自动启用 WordPress 调试模式，从而记录和保存网站上的错误信息，供分析和故障排查使用。

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

可以通过 sFTP 访问并修改 wp-config.php 文件来启用错误日志记录和 WordPress 调试模式。

注意：这个方法需要格外小心，因为代码中出现错误可能会对网站造成严重影响。

步骤 1：通过 sFTP 连接到网站

1. 启用网站的 sFTP 功能。

• 进入 My Site(s) → Settings → Hosting Configuration。
• 点击“Enable SFTP”按钮。
• 会获得 sFTP 登录信息，包括 URL、端口号、用户名和密码。

2. 使用像 FileZilla 这样的 FTP 软件，通过这些凭据连接到网站。

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

1. 找到网站根目录中的 wp-config.php 文件。
2. 下载文件的副本，作为备份。

步骤 3：编辑 wp-config.php 文件

1. 用文本编辑器（例如 Notepad）打开 wp-config.php 文件。
2. 找到下面这行代码：

define('WP_DEBUG', false);

并将其替换为下面这行代码：

define('WP_DEBUG', true);


if (WP_DEBUG) {


       @error_reporting(E_ALL);


       @ini_set('log_errors', true);


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


       define('WP_DEBUG_LOG', true);


       define('WP_DEBUG_DISPLAY', false);


       define('CONCATENATE_SCRIPTS', false);


       define('SAVEQUERIES', true);


}

3. 保存文件并上传回网站的根目录。

重要提醒：调试完成后，一定要关闭此功能，因为长时间启用调试模式可能会让网站更容易受到黑客攻击。

如何关闭 WordPress 调试模式？

为了提高 WordPress 的性能和安全性，我们建议在排查问题后关闭调试模式。长期开启调试模式可能会降低网站速度，甚至暴露敏感信息。

如果通过代码启用了调试模式

要关闭错误日志记录，只需删除之前添加的代码，并将下面代码恢复为默认值：

define('WP_DEBUG', false);

如果通过插件启用了调试模式

可以通过下面步骤关闭调试模式：

1. 进入 插件（Plugins） 页面。
2. 找到 WP Debugging 插件并将其停用即可。

如何查找或访问 WordPress 错误日志？

启用 WordPress 调试模式后，需要加载网站以触发错误代码，这些错误将记录在名为 debug.log 的文件中。要通过 sFTP 访问该文件，可以按照之前提到的步骤操作。

定位 debug.log 文件

1. 导航到网站根目录中的 wp-content 文件夹。
2. 如果存在错误，能看到 debug.log 文件；如果没有错误，该文件将不会出现，说明网站运行正常。

查看 debug.log 文件

1. 找到 debug.log 文件后，将其下载到电脑上。
2. 用文本编辑软件（如 Notepad）打开文件，查看完整的日志内容。

日志文件包含重要信息，可以帮助快速定位问题的来源。

如何解决 WordPress 错误日志中发现的问题

debug.log 文件提供了有关网站错误和警告的重要信息，但该文件不应直接编辑，而是用作参考，方便识别网站、主题、插件或代码中的问题。

用 debug.log 文件的步骤

1. 定位错误或警告
   浏览日志文件，查找记录的错误或警告。
2. 记录错误代码
   注意与错误条目相关的错误代码。
3. 查找错误代码的含义
   搜索错误代码以了解具体问题的详情。
4. 查阅相关指南或资源
   根据错误代码，查找解决该问题的具体方法。

debug.log 文件的内容

日志中的每条记录通常包括以下信息：

• 日期和时间
• 模块
• 进程 ID
• 访问者的 IP 地址

然而，最重要的部分是错误信息本身。例如：

• “File not found“（文件未找到） 错误，通常表示某个文件缺失，并会提供文件路径。
• 提示错误（如 “bot detected for vhost”），可能表明服务器关闭了连接。日志中还会进一步说明原因，例如检测到潜在有害的机器人。

修复错误的常见方法

• 更新已移动或删除的文件路径。
• 如果是服务器错误，则根据日志提供的详细信息采取相应措施。

重要提醒：debug.log 文件仅用于故障排查，不要直接修改。它是诊断和解决网站问题的工具。

如何利用错误日志识别并解决性能相关问题

WordPress 错误日志中可能出现各种类型的问题，虽然无法一一列举，但通过一个示例可以了解如何利用错误日志来识别和解决性能相关问题。

示例：权限错误

权限错误会在错误日志中触发 PHP 警告。这种错误通常发生在文件被错误权限访问时。

一个常见的场景是通过 sFTP 上传文件后，没有在 wp-admin 仪表盘中重置权限，从而导致文件权限设置不正确。解决此类问题时，需验证日志中提到的文件是否存在。

示例 1

PHP Warning: The stream could not be opened for writing to the file "/path/to/yourblog/wp-content/themes/badperms/lib/css/theme.css" due to permission denied. This error originated in the file "/path/to/yourblog/wp-content/themes/WFTDAtv/lib/less/lessc.inc.php" on line 1418...

示例 2：

[Sat May 31 21:30:22 2023] [error] [client 127.0.0.1] PHP Warning: The stream could not be opened for writing to the file "/path/to/yourblog/wp-content/themes/yoo_phoenix_wp/cache/xml-80a72b04a693554d055946d5ad954588.php" due to permission denied. This error occurred in the file "/path/to/yourblog/wp-content/themes/yoo_regvis_wp/warp/helpers/xml.php" on line 34. Referring page: http://example.com/wp-admin/customize.php

示例 3：

PHP Warning: Failed to open the stream for writing to the file "/path/to/yourblog/wp-content/cache/autoptimize/autoptimize_f7d7e4c8e9a3146b6b514d7e7f9e2468.php" due to permission denied. This error originated in the file "/path/to/yourblog/wp-content/plugins/plugin_folder/plugin_file.php" on line 22...

总结

WordPress 错误日志在高效故障排查和维护可靠的在线体验中起着至关重要的作用。它们能够帮助及时识别并解决错误，从而保护访客的使用体验。此外，备份和测试环境就像安全网，可以在出现问题时撤销错误，确保网站的稳定运行。

常见问题解答

问：在哪里可以找到 WordPress 日志？
答：要访问错误日志，请前往文件管理器中的 /wp-content/ 文件夹，查找 debug.log 文件。该文件存储了所有记录的 WordPress 错误，便于审查和故障排查。

问：什么是 WordPress 日志？
答：WordPress 错误日志是一个宝贵的故障排查工具，可以帮助识别由插件、主题或代码引发的问题来源。

问：什么是 WordPress 调试日志？
答：WordPress 提供内置的调试工具，帮助识别网站错误的根本原因。虽然它能提供有用的信息，但由于潜在的安全风险，不建议在公开的在线网站上启用调试功能。

问：直接编辑 WordPress 日志文件中的错误是否安全？
答：虽然可以编辑文件，但通常不建议这样做。直接编辑可能引入新错误或删除重要信息，风险较大。

问：可以删除 WordPress 错误日志吗？
答：可以删除错误日志文件，但请注意，这将会清除所有已记录的错误。

问：WordPress 是否有活动日志？
答：是的，WordPress 有活动日志，用于记录用户操作和系统事件。可以通过管理员仪表盘中的“工具” -> “活动日志”访问。

问：WordPress 中的 PHP 错误日志在哪里？
答：PHP 错误日志通常在 WordPress 安装的根目录下，文件名为 wp-content/debug.log。