WordPress 错误通常指向某个系统环节,而不是有一个通用修复方法。编辑文件或停用插件之前,先记录完整错误信息、网址和发生时间,检查近期变更,并确认备份可以恢复。可能影响访客或数据的测试,应先在 staging 环境重现。

排查前先做这些检查

White Screen of Death
图示:排查前先做这些检查。
  • 确认问题影响所有访客、某个帐号、某个浏览器还是某个网络。
  • 记录受影响的网址、时间和时区、重现步骤,以及近期更新或部署。
  • 查看主机、PHP、Web 服务器、数据库和 WordPress 在同一时间的日志。
  • 不要向访客显示调试错误。请妥善保管日志,因为其中可能包含路径或数据。
  • 每次只改一个地方,并记录如何还原。
  • 修复后,测试相关流程,以及相邻页面、表单、结账和系统整合。

30 种常见 WordPress 错误

1. 白屏或空白页面

检查:首次出错时的 PHP 和 Web 服务器日志,以及近期代码或插件变更。避免:尚未找到线索就调整内存限制或停用所有插件。

2. “此网站发生严重错误”

检查:恢复模式电邮、WordPress 致命错误日志和主机 PHP 日志。接着:使用恢复模式或 staging 环境逐一排查组件。不要公开分享恢复链接。

3. HTTP 500 内部服务器错误

检查:服务器日志、部署记录、PHP 错误和重写规则配置。请主机服务商确认服务器端限制。单凭 500 响应无法确定原因。

4. 无法连接数据库

检查:数据库服务状态、连接凭据、主机值、连接数限制和近期配置变更。运行修复命令前,先联系主机服务商或数据库管理员。

5. 连接逾时

检查:是否只有某个请求逾时、服务器是否可访问,以及相关代理和服务器日志。再将资源用量与主机限制比较。

6. “正在进行定期维护,请稍后回来”一直显示

检查:WordPress 核心、插件或主题更新是否仍在运行,以及文件是否只更新了一部分。确认更新已结束并有备份后,才移除维护标记。

7. PHP 语法或解析错误

检查:私有错误日志中列出的文件和行号,以及最近一次代码修改。在 staging 环境修正代码或还原已知可用版本,不要在正式网站上猜测修改。

8. 图片上传失败

检查:文件格式和大小、可用储存空间、上传限制、权限,以及 PHP 或代理日志。避免使用 777 这类过度开放的权限设置。

9. 无法登入管理员帐号

检查:帐号状态、密码重设电邮、网址和 HTTPS 设置、安全日志及近期访问变更。排查期间应保留一个获授权的管理员帐号。

10. WordPress 或扩展更新失败

检查:更新日志、磁盘空间、文件拥有者、网络连接和兼容性。不要随意把文件覆盖到正式网站。先备份,再依照官方更新或恢复流程处理。

11. 网站无法发送电邮

检查:系统是否生成电邮、邮件日志、发件网域验证和收件方退信。表单显示成功并不代表电邮已送达。使用有监控的邮件服务并测试收件。

12. HTTPS 证书警告

检查:证书是否有效、主机名称是否相符、续期状态、代理/CDN 模式和源站设置。不要关闭证书检查来掩盖警告。

13. 插件冲突或功能失效

检查:日志以及问题发生前的变更。在 staging 环境重现问题,再逐一测试可疑组件。不要在正式网站上随意停用安全、付款或缓存组件。

14. 主题版面或模板损坏

检查:浏览器控制台、服务器日志、近期主题变更和模板兼容性。更改正式主题前,先在 staging 测试仍受支持的默认主题。

15. 内部链接指向不存在的页面

检查:目标网址、重定向链、已删除内容和近期固定链接变更。只有在确实相关时,才更新链接或重定向到替代页面。

16. 页面加载缓慢

检查:服务器响应、浏览器网络时间、大型资源、第三方脚本、数据库活动和缓存行为。先测量,再考虑安装其他优化插件。

17. 达到主机的流量或资源限制

检查:主机用量报告、流量模式、备份任务和大型下载。减少不必要的传输,并与服务商商议容量调整。

18. RSS 订阅格式错误或无法访问

检查:订阅网址、响应状态、近期主题或插件变更,以及 XML 输出。应修正输出错误的来源,不要随意插入空格来补救。

19. 侧栏或内容位置错乱

检查:浏览器控制台、HTML 结构、CSS 变更,以及不同屏幕宽度下的问题模板。验证标记结构,并隔离近期样式变更。

20. 主题提示缺少样式表

检查:上传的是否为可安装主题文件夹,以及预期位置是否有 style.css。不要把供应商的整个下载压缩包当成主题上传。

21. PHP 内存耗尽

检查:致命错误、工作负载、PHP 配置和插件或主题活动。提高限制可能只是掩盖低效代码。先确认主机允许调整,再监测结果。

22. 电邮被归入垃圾邮件或遭拒收

检查:退信信息、发件网域一致性、SPF、DKIM 和 DMARC 设置、发件声誉及收件方过滤规则。DNS 变更应与网域负责人协调。

23. 上传媒体时出现 HTTP 错误

检查:浏览器响应、服务器和 PHP 日志、图片尺寸、储存空间及请求大小限制。可用较小副本测试是否与文件大小有关,但不要取代原始文件。

24. WordPress 通知重复或没有送出

检查:表单或订单日志、插件钩子、邮件队列和重复整合。提交一次测试,并从触发到送达逐步追踪。

25. 社交分享显示错误图片或标题

检查:网页源代码中的 Open Graph 元数据、规范网址、图片可访问性和社交平台缓存。先修正网页元数据,再在平台支持时重新抓取预览。

26. 修改 PHP 后出现解析错误

检查:错误日志中的准确文件和行号,以及最近的代码变更。还原可用副本或使用版本控制。语法修正前不要继续修改正式网站。

27. 主题更新不完整

检查:主题版本、更新日志、文件拥有者,以及是否直接修改了父主题。自定义代码应放在子主题或受管理的代码库中,并依照供应商支持的恢复步骤处理。

28. 自定义内容类型网址出现 404

检查:内容类型是否已注册、重写设置和生成的网址。确认设置后,通过受支持的应用流程刷新重写规则;也要检查重定向和服务器规则。

29. 后台控制项没有反应

检查:浏览器控制台和网络错误、JavaScript 优化、用户权限及近期插件变更。先在干净的浏览器会话和 staging 环境重现问题,再考虑停用扩展。

30. 网站显示一般服务器错误

检查:状态码、请求时间、服务器日志和近期基础设施变更。如果应用日志没有记录,请主机服务商追踪请求。不要假设所有服务器错误都源自 WordPress。

何时应停止自行排查并寻求协助

如果网站可能遭入侵、数据可能损坏、结账或个人资料受到影响,或恢复步骤不明确,请暂停自行修改。向技术人员提供时间线、受影响网址、完整错误信息、近期变更、相关日志和备份状态。切勿在公开论坛发送密码或个人资料。

若线上 WordPress 网站出现营运问题,请查看 Ulement 的 WordPress 紧急支援服务。

资料核对日期:2026 年 10 月 20 日。WordPress 调试文档、WordPress 故障排查指南和 WordPress 备份指南。