简介
当 WordPress 插件出现问题时，往往很难确定确切原因。问题可能源于插件冲突、主题不兼容或服务器配置问题。由 WordPress.org 团队开发的“Health Check & Troubleshooting”插件是一款强大的诊断工具，可以帮助您隔离并找出这些问题。
什么是 Health Check & Troubleshooting？
Health Check & Troubleshooting 是 WordPress.org 官方插件，可让您：
- 对您的 WordPress 安装进行诊断
- 进入“故障排除模式”，仅在您的用户会话中停用所有插件并切换到默认主题
- 有选择地重新启用插件和主题，以找出冲突
- 收集网站的技术信息，用于寻求支持
其主要优势在于，故障排除模式只影响您这个管理员用户；在您诊断问题期间，访客看到的网站仍然一切正常。
安装
- 登录您的 WordPress 仪表盘。
- 前往“插件 > 安装插件”。
- 搜索“Health Check & Troubleshooting”。
- 点击“立即安装”，然后点击“启用”。
检查浏览器控制台中的 JavaScript 错误
在使用 Health Check 插件之前，最好先检查是否存在可能导致功能异常的 JavaScript 错误：
- 打开浏览器的开发者工具：
- Chrome/Edge：按 F12，或右键点击并选择“检查”。
- Firefox：按 F12，或右键点击并选择“检查元素”。
- Safari：在“偏好设置 > 高级”中启用开发者工具，然后按 Option+Command+I。
- 前往“控制台”选项卡。
- 操作出现问题的功能（点击按钮、提交表单等）。
- 查找控制台中出现的红色错误消息。
- 留意错误中提到的脚本名称。
- 记下文件路径中涉及特定插件的内容。
- 查找“undefined”或“null”之类的错误。
- 记录发现的所有错误，以便与支持团队共享。
JavaScript 错误通常可以直接指出是哪个插件导致了问题，或为判断冲突的性质提供有价值的线索。
使用故障排除模式诊断问题
第 1 步：进入故障排除模式#
- 前往“工具 > 站点健康”。
- 点击“故障排除”选项卡。
- 点击“启用故障排除模式”按钮。
- WordPress 将以基本状态重新加载：所有插件均被停用，并使用默认主题（仅针对您的会话）。
第 2 步：测试您的问题#
进入故障排除模式后，测试您遇到的问题是否仍然出现：
- 如果问题已解决（不再出现）：这表明问题与某个插件或您的主题有关。
- 如果问题仍然存在：问题可能与 WordPress 核心文件、服务器配置或数据库有关。
第 3 步：系统化测试（如果问题已解决）#
如果问题在故障排除模式下得到解决，请按以下步骤找出具体原因：
- 仍处于故障排除模式时，点击主题旁边的“启用并测试插件”，测试是否是主题导致了问题。
- 如果问题再次出现，说明是主题导致的。
- 如果问题没有再次出现，请继续测试插件。
- 逐个启用插件：
- 点击插件旁边的“启用并测试插件”。
- 每启用一个插件，都测试一下问题是否再次出现。
- 继续操作，直到找到导致问题再次出现的插件。
- 找到冲突的插件或主题后：
- 将其记录下来。
- 您可以让它保持停用状态，或联系开发者寻求支持。
第 4 步：退出故障排除模式#
找出问题后：
- 点击屏幕顶部的“禁用故障排除模式”。
- 您的网站将恢复正常状态，所有插件和主题都会重新生效。
找出冲突后该怎么办
如果问题出在插件上：#
- 检查该插件是否有可用的更新。
- 在该插件的支持论坛中搜索类似问题。
- 联系插件开发者，并提供以下具体信息：
- WordPress 版本
- PHP 版本
- 其他已启用的插件
- 重现问题的步骤
- 浏览器控制台中的所有错误消息
如果问题出在主题上：#
- 检查是否有可用的主题更新。
- 考虑暂时切换到 WordPress 默认主题。
- 联系主题开发者并提供具体信息。
如果在故障排除模式下问题仍然存在：#
这表明可能存在更深层的问题，例如：
- WordPress 核心文件完整性问题
- 数据库损坏
- 服务器配置问题
- PHP 版本兼容性问题
在这些情况下，可以考虑：
- 运行站点健康检查（工具 > 站点健康 > 状态）
- 咨询您的主机服务商
- 向 WordPress 开发者寻求帮助
高级故障排除技巧
使用 Health Check 调试信息#
- 前往“工具 > 站点健康 > 信息”。
- 此页面包含有关您的 WordPress 配置的详细信息。
- 点击“复制站点信息到剪贴板”，与支持团队共享。
使用其他用户账户进行测试#
有些问题只会影响特定的用户角色：
- 创建一个具有不同角色的临时用户账户。
- 测试该新用户账户是否也会出现问题。
检查服务器错误日志#
服务器错误可能不会显示在浏览器中：
- 在主机控制面板中查看错误日志。
- 或者添加
define('WP_DEBUG', true);和define('WP_DEBUG_LOG', true);到您的 wp-config.php 文件中。 - 错误将记录到 /wp-content/debug.log 中。
高效排查的技巧
- 二分查找法：对于插件较多的网站，请采用“分而治之”的方法：
- 启用一半插件并进行测试。
- 如果问题出现，说明问题出在这一半中；如果没有，则出在另一半中。
- 继续将有问题的那组插件一分为二，直到找出问题所在。
- 插件较多时，这种方法比逐个测试插件要快得多。
- 复杂冲突：请注意，有些问题是由多个插件组合导致的：
- 如果无法确定是哪一个插件有问题，请尝试测试不同的组合。
- 留意功能相似的插件（例如多个 SEO 插件、多个缓存方案）。
- 有时两个插件单独使用时都正常，但一起使用时就会发生冲突。
- 有条理地记录：详细记录您测试过的内容及结果。
- 最近的更改：先测试最近安装或更新过的插件或主题。
- 常见元凶：优先测试影响较大的插件（缓存、安全、优化类插件）。
- 清除缓存：测试时，请务必清除所有缓存插件的缓存。
- 浏览器测试：在多个浏览器中进行测试，以排除特定浏览器的问题。
何时联系插件支持团队
如果您已找出问题但无法自行解决：
- 收集全面的信息：
- WordPress 版本
- PHP 版本
- 已启用插件的完整列表
- 主题名称和版本
- 浏览器和设备信息
- 重现问题的确切步骤
- 截图或录屏（如适用）
- 浏览器控制台中的所有错误消息
- 查阅现有文档：
- 查看该插件的知识库。
- 在该插件的支持论坛中搜索类似问题。
- 提交详细的支持工单：
- 附上上面收集的所有信息。
- 具体说明您已经尝试过的方法。
- 说明您已使用 Health Check 隔离了问题。
- 如果可行且合适，请提供临时管理员访问权限。
您在首次支持请求中提供的信息越多，支持团队就能越快地帮助您解决问题。
结语
Health Check & Troubleshooting 插件是一款非常实用的工具，可以在不影响线上网站的情况下诊断 WordPress 问题。通过系统地测试插件和主题，您可以找出冲突，并在需要时向支持团队提供详细信息。
提示：在对插件、主题或核心文件进行重大更改之前，请务必备份您的 WordPress 网站。
参考资源#
更新于 2026年4月16日 · 需要帮助？请提交支持工单