WordPress故障排查指南：按顺序检测5个关键环节

网站突然打不开、页面一片空白或者弹出一条错误代码？

别急着找人付费修，大部分 WordPress 故障都能通过一套标准步骤快速定位。

今天这份 WordPress故障排查指南 会从最基础的准备开始，按优先级列出 5 个必须检测的环节，每一步都给出命令或面板操作路径——哪怕你现在只开过电脑，也能跟着做。

排查前先确认这三件事

动手之前，先确认基础环境是否正常，避免从根上就找错方向。

切换到宝塔面板或服务器终端，按以下顺序检查：

• 服务器是否在线？ 登录宝塔面板，查看首页的“CPU / 内存 / 磁盘占用”区域。如果磁盘使用率超过 90%，WordPress 可能因无法写入日志而报错。如果面板都打不开，先重启服务器（云服务商后台 → 实例 → 重启）。


• PHP 服务是否运行？ 在宝塔面板的“软件商店”中找到 PHP（通常是 7.4 / 8.0 / 8.1），点击“设置” → “性能调整”，确认状态为“已运行”。如果显示“未运行”，直接点“启动”。


• MySQL / MariaDB 是否正常？ 同样在软件商店找到 MySQL，查看状态。如果连接失败（常见报错：Error establishing a database connection），先重启 MySQL 服务。

第一步：清理浏览器缓存并启用主题/插件排查

很多“网站打不开”其实是浏览器缓存了旧的错误页面。先做最快速的操作：

1. 打开浏览器无痕模式（Ctrl+Shift+N / Cmd+Shift+N）重新访问网站。


2. 如果正常，说明是缓存问题；如果依旧报错，进入下一步。


3. 禁用所有插件：通过宝塔面板的文件管理，进入 /www/wwwroot/你的域名/wp-content/plugins 目录，将 plugins 文件夹重命名为 plugins_bak（临时禁用所有插件）。再次访问网站。恢复正常 → 插件冲突；仍报错 → 继续。


4. 切换默认主题：用命令或面板进入 /www/wwwroot/你的域名/wp-content/themes，将当前主题文件夹重命名（例如 twentytwentyfour_bak），WordPress 会自动使用默认主题（Twenty Twenty-Four 等）。恢复正常 → 主题兼容性问题。

第二步：查看 PHP 错误日志与 WordPress 调试信息

如果第一步没解决，需要看具体的报错细节。

• 启用 WordPress 调试模式：通过宝塔面板进入站点根目录，编辑 wp-config.php 文件，找到 WP_DEBUG 相关行，确保如下内容存在（没有则添加）：

define('WP_DEBUG', true);

define('WP_DEBUG_LOG', true);

define('WP_DEBUG_DISPLAY', false);

保存后再次访问报错页面，然后检查根目录下新生成的 wp-content/debug.log 文件（用面板文件管理器直接查看）。

里面会明确记录是哪个插件、哪个函数导致的 PHP 错误。

• 查看 PHP 错误日志：在宝塔面板“网站” → 你的站点 → “设置” → “PHP” → “错误日志”，直接加载最新的报错行。常见的“Fatal error: Uncaught Error”后面会附上文件路径和行号。

第三步：检查 .htaccess 与伪静态规则

白屏或 404 经常是 .htaccess 文件损坏导致的。

在宝塔面板“网站” → 你的站点 → “网站目录”，将“伪静态”设置为“WordPress”（或之前已设置则重新保存一次）。

如果问题依然存在，通过文件管理器删除站点根目录下的 .htaccess（会生成新文件），然后在 WordPress 后台“设置 → 固定链接”中再次保存一次，重新生成规则。

第四步：常见报错与对应解决（高频问题解答）

• 报错“Error establishing a database connection” → 检查 wp-config.php 中的数据库用户名、密码、主机名（通常为 localhost）是否正确；在宝塔面板“数据库”中重启 MySQL 服务。


• 报错“Internal Server Error (500)” → 优先查看 PHP 错误日志；如果日志为空，检查站点目录下的 .user.ini 或 php.ini 中 max_execution_time 是否过小（改为 300 并重启 PHP）。


• 报错“Failed to open stream: Permission denied” → 文件或目录权限错误。在宝塔面板“网站” → 你的站点 → “网站目录”，勾选“覆盖权限”，将目录权限设为 755，文件设为 644（一键修复）。


• 报错“The site is experiencing technical difficulties” → 这是 WordPress 自身捕获的致命错误。直接在 FTP 或文件管理器中删除 /wp-content/plugins/ 下的最近安装的插件文件夹，即可解除。

第五步：验证结果与恢复设置

问题解决后，务必关闭调试模式，否则日志文件会不断增大且暴露敏感信息。

修改 wp-config.php：

define('WP_DEBUG', false);

define('WP_DEBUG_LOG', false);

然后分步恢复插件和主题：将之前重命名的文件夹改回原名，一次只激活一个插件，每次激活后访问网站确认正常。

同理，恢复自定义主题。

如果你按照这份 WordPress故障排查指南 完成了全部操作，大多数常见错误都能在 10 分钟内定位。

遇到实在无法解决的报错，将 debug.log 中的关键行复制到百度或 Google 搜索，通常能找到别人的解决方案。

避坑提醒

• 不要在 wp-config.php 中同时开启 WP_DEBUG_DISPLAY 和 WP_DEBUG_LOG，否则错误信息会直接显示在页面前端，可能泄露数据库信息。


• 修改任何核心文件（如 wp-config.php、.htaccess）前，先备份原文件。宝塔面板支持右键“复制”到同目录下。


• 如果站点使用 CDN（如 Cloudflare），排查时先开启“开发模式”或临时关闭 CDN，避免刷到缓存内容影响判断。

以上步骤适用于绝大多数 WordPress 故障场景。

把这篇文章收藏起来，下次网站出问题时打开照着做，省时省力。