遇到报错先别慌。下面按“现象 → 常见原因 → 处理步骤”整理了 WordPress 最常见的报错。处理前建议先备份，并按插件冲突排查流程打开调试日志。
关键数据
| 指标 | 对照值 | 口径说明 |
|---|---|---|
| HOWTO步骤数 | 11步 | 改造对照基线 / 可迁移验收口径 |
| 引用官方文档数 | 4篇 | 改造对照基线 / 可迁移验收口径 |
| 失败模式条目 | 12个 | 改造对照基线 / 可迁移验收口径 |
| 清单可勾选项 | 12项 | 改造对照基线 / 可迁移验收口径 |
| 清单可勾选项 | 24项 | 改造对照基线 / 可迁移验收口径 |
| 失败模式条目 | 13个 | 改造对照基线 / 可迁移验收口径 |
1. 白屏 / 网站遇到致命错误
- 原因：插件或主题 PHP 致命错误、PHP 版本不兼容、内存不足。
- 处理：查看 debug.log 或管理员邮箱收到的恢复模式邮件；通过恢复模式或重命名插件目录停用故障插件。
2. 500 Internal Server Error
- 原因：.htaccess 或 Nginx 伪静态规则错误、PHP-FPM 崩溃、文件权限问题。
- 处理：查看服务器错误日志；Apache 环境重置 .htaccess；检查 PHP-FPM 状态与权限。
3. 建立数据库连接时出错
- 原因：wp-config.php 中数据库名、用户名、密码或主机填写错误；MySQL 服务停止；连接数耗尽。
- 处理：核对配置；在面板中检查 MySQL 状态并查看日志；必要时修复数据表。
4. Allowed memory size exhausted
- 原因：PHP 内存上限过低，或某个插件存在异常的内存消耗。
- 处理：在 wp-config.php 设置
WP_MEMORY_LIMIT，同时查明消耗异常的插件。
5. “正在执行例行维护，请一分钟后回来”
- 原因：更新中断，根目录残留 .maintenance 文件。
- 处理：删除该文件，再重新执行更新。
6. 重定向次数过多（ERR_TOO_MANY_REDIRECTS）
- 原因：站点地址与实际协议不一致、CDN 与服务器 HTTPS 配置冲突、插件强制跳转。
- 处理：核对 siteurl 与 home 选项；检查 CDN 的 SSL 模式；反向代理环境需正确识别 HTTPS。
7. 更新失败 / 无法创建目录
- 原因：文件所有者或权限错误、磁盘空间不足。
- 处理：将站点目录所有者设为 Web 用户（宝塔环境通常为 www），检查磁盘空间。
8. 上传文件超过限制
- 原因：PHP 的 upload_max_filesize、post_max_size 或 Nginx 的 client_max_body_size 过小。
- 处理：三处同时调大，并重载服务。
9. 打开网站直接下载文件
- 原因：Web 服务器未正确把请求交给 PHP 解析，或 HTTPS 站点配置缺失被其他站点接管。
- 处理：检查站点配置中的 PHP 处理规则与 443 端口配置。
10. 后台很慢 / 编辑器卡顿
- 原因：插件后台请求过多、Heartbeat 频繁、autoload 选项过大、外部请求超时。
- 处理：用 Query Monitor 定位，必要时启用对象缓存，参考性能优化方案。
以上步骤都无法解决，或者故障反复出现，可以申请免费诊断，我们协助定位根因。安全相关的异常请同时参考安全加固清单。
参考与依据
技术判断以权威文档为准，便于 SEO/GEO 场景下核对来源：WordPress 开发者文档；WordPress.org 官方文档。站内实践再落到主题、插件与验收清单。
