查找 WooCommerce 与服务器上的 PHP 错误日志

调查 WordPress 与 WooCommerce 网站问题时，PHP 错误日志很有帮助。本指南介绍如何在 WooCommerce 内部或托管服务器上访问 PHP 错误日志。

WooCommerce 日志

WooCommerce 提供日志系统，可在 WordPress 后台的“WooCommerce > 状态 > 日志”访问。它会记录 PHP 致命错误及其他信息。

该日志非常适合作为排查起点，其中的信息通常也会出现在服务器的 PHP 错误日志中。建议先查看这里，再定位服务器上的 PHP 日志进行进一步排查。

日志文件浏览器

访问日志文件的方法：

1. 在商店的 WordPress 后台进入“WooCommerce > 状态 > 日志”。
2. 在“浏览日志文件”下，可以看到可用日志文件列表。

日志文件浏览器。

通过此界面，可以高效筛选、排序和管理日志文件。也可以选择多个文件，利用“批量操作”下拉框，一次下载或删除多个日志。

批量下载日志文件。

搜索日志

使用筛选与排序选出一组文件，进行有针对性的搜索。随后可以直接链接到文件中包含相关结果的具体行。

在日志文件内搜索。

单文件查看器

此视图显示单个日志文件的内容，突出标识新日志条目的起点及严重程度。可以高亮文件中的特定行，为其创建永久链接，并以清晰易读的格式查看每条日志的额外上下文。

通过文件查看界面右上角的按钮，可以下载或永久删除该日志文件。

单个日志文件查看器。

设置

通过“WooCommerce > 状态 > 日志 > 设置”调整日志管理选项：

• 日志记录器：启用或停用日志记录。
• 日志存储：决定日志条目保存在哪里。默认自动选择“文件系统”。另一个选项是“数据库”，但不建议在正式网站使用。改变该选项不会迁移已有日志，旧日志仍保留在原位置。
• 保留期限：定义日志自动删除前保留多少天，默认 30 天。
• 级别阈值：指定记录日志的最低严重程度，低于阈值的日志不会记录。默认为“无”，表示保留所有日志。选项包括 Alert、Emergency、Debug、Critical、Error、Warning、Notice、None 和 Info。
• 文件系统设置：显示服务器上日志文件的存放路径，例如 /srv/htdocs/wp-content/uploads/wc-logs/。可以在 wp-config.php 中将 WC_LOG_DIR 常量设为新路径，从而修改此位置。

WooCommerce 日志设置。

致命错误

查看致命错误的方法：

1. 在后台进入“WooCommerce > 状态 > 日志”。
2. 在“浏览日志文件”页面，选择一个 fatal-errors 文件，打开并查看其内容。

致命错误日志会捕获 PHP 致命错误、运行时错误，以及代码通过 PHP 函数主动触发的错误。例如，代码拼写错误可能导致运行时错误。

当代码中的操作无法完成时，就会发生致命错误。原文列举的例子包括调用未定义的函数、使用未定义的变量，以及在 null 或其他不可用变量上调用函数。

这里不包括超时等 Web 服务器错误。

日志包含：

• 错误发生的时间戳。
• 发生的错误。
• 错误起源的代码文件与行号。
• 堆栈跟踪，即导致错误的函数调用和文件历史快照。

服务器上的 PHP 错误日志

托管服务器上，PHP 错误日志可能出现在以下位置：

• 服务器根目录，文件名 error.log。
• public_html 或类似目录，文件名 error.log。
• var/logs 或类似目录，文件名 error.log。

如果已经在 WordPress 中开启调试，并配置写入日志文件，则日志位于 wp-content 目录，名为 debug.log。

如果难以找到文件，可以让 PHP 显示其位置：

1. 在 WordPress 根目录创建 phpinfo.php。
2. 使用文本编辑器打开它。
3. 写入以下代码：

<?php phpinfo(); ?>

4. 在网站上打开该文件。例如，网站地址是 example.com，就访问 https://example.com/phpinfo.php。
5. 在页面中搜索 error_log。这里列出的路径是 PHP 错误日志的绝对路径，到服务器上访问该位置即可看到日志。如果值为空，需要设置相应值，才能记录网站错误。

下面展示了输出应有的样子：

PHP 信息输出示例。

问题与支持

仍有疑问、需要帮助吗？本文介绍免费 WooCommerce 核心插件，支持通过 WordPress.org 社区论坛提供。先搜索论坛，常常能发现问题已经有人提出并得到解答。尚无 WordPress.org 账户时，可以先注册。

要扩展这里展示的核心功能，建议查看 WooCommerce Marketplace 中的扩展。

需要持续高级支持或定制开发，可以聘请 Woo Agency Partner。正在开发 WooCommerce 集成或扩展的开发者，可查看开发者资源。

如果仍未找到需要的信息，可以使用原文页面底部的反馈按钮通知文档维护者。

原文：Finding PHP error logs。作者／维护方：WooCommerce 文档团队。本文为中文翻译，代码及命令保留原文。

原站版权声明：© WooCommerce, Inc. 2026。