启用 WooCommerce 插件后网站白屏显示致命错误如何排查

启用 WooCommerce 后出现白屏或致命错误，通常由 PHP 内存不足、插件冲突或文件系统权限问题引起。最直接的处理方式是开启 WordPress 调试模式定位报错文件，并通过 FTP 临时禁用插件恢复访问。

先说结论：优先通过 wp-config.php 开启调试日志，结合 FTP 重命名插件文件夹排查冲突，必要时增加 PHP 内存限制。

快速处理思路

若无法进入 WordPress 后台，需通过 FTP 或主机文件管理器直接操作网站根目录文件。

1. 开启调试模式：编辑根目录 wp-config.php 文件，将 define('WP_DEBUG', false); 修改为 define('WP_DEBUG', true);，并添加 define('WP_DEBUG_LOG', true);。

2. 增加内存限制：在 wp-config.php 中添加 define('WP_MEMORY_LIMIT', '256M');，解决因 WooCommerce 资源占用导致的内存溢出。

3. 禁用插件排查：通过 FTP 进入 wp-content 目录，将 plugins 文件夹重命名为 plugins_old，强制禁用所有插件。

WooCommerce 属于资源密集型插件，容易触发服务器内存限制或与其他插件代码冲突。

白屏死机通常意味着 PHP 脚本耗尽了内存限制，或者发生了未被捕获的致命错误导致服务器停止渲染页面。部分错误如 ftp_nlist() 类型错误，是因为 PHP 文件系统方法配置不当，无法正确访问服务器文件。

步骤 1：开启调试日志
编辑 wp-config.php 文件，在 /* That's all, stop editing! Happy publishing. */ 之前加入以下代码：

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

刷新页面后，查看 wp-content/debug.log 文件获取具体错误信息。

步骤 2：调整内存限制
若日志提示内存不足，在 wp-config.php 中添加：

define('WP_MEMORY_LIMIT', '256M');

步骤 3：解决文件系统错误
若报错涉及 ftp_nlist() 或文件权限，在 wp-config.php 中添加：

define('FS_METHOD', 'direct');

步骤 4：排查插件冲突
若上述无效，通过 FTP 重命名 wp-content/plugins 为 plugins_old。网站恢复后，将文件夹名改回，并逐一重命名内部插件文件夹直到找到冲突源。

操作完成后，刷新网站首页和后台登录页面。若白屏消失且能正常访问，说明修复生效。检查 wp-content/debug.log 文件不再新增致命错误日志。若之前收到“您的站点存在技术问题”邮件，点击邮件中的恢复模式链接也可验证是否能进入后台。

1. 调试模式未关闭：修复后务必将 WP_DEBUG 改回 false，避免向访客泄露错误信息。

2. 维护文件残留：若更新中断，根目录可能遗留.maintenance 文件，需手动删除。

3. 权限问题：确保 WordPress 文件和目录具有正确的读写权限，避免文件无法写入导致错误。

邮件中包含恢复模式链接，点击链接登录后可暂停导致错误的插件或主题。

检查 MySQL 进程是否运行，重启数据库服务，并核对 wp-config.php 中的数据库用户名和密码。

检查语法错误，确保代码添加在正确位置，或通过 FTP 恢复备份文件。