主机资讯与使用指南
WordPress 网站打不开怎么排查:数据库错误、白屏与 502
根据连接超时、数据库连接错误、白屏和 502,定位 WordPress 网站的服务、PHP、插件与数据库问题。
先看浏览器给出的结果
连接超时或拒绝连接,先查域名、实例状态、端口和防火墙。已有 HTTP 错误页面,说明请求已经到达某一层服务,再按错误处理。
curl -I https://blog.example.com把 blog.example.com 换成自己的域名。状态码只帮助定位入口,CDN 也可能返回自己的错误页,继续看源站日志。
Error establishing a database connection
查看 wp-config.php 的数据库名称、用户、密码和主机。数据库在 Compose 中时,程序与数据库要在同一网络,主机通常填数据库服务名,不填容器里的 localhost。
检查数据库服务是否运行、磁盘是否还有空间,以及应用用户能否连接目标数据库。刚迁移后出错,优先检查新环境连接参数。
白屏与插件升级错误
查看 PHP 错误日志;需要 WordPress 调试日志时,在 wp-config.php 的结束提示之前添加或调整对应设置,不重复定义相同常量。
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );复现一次后查看 wp-content/debug.log。日志可包含路径等信息,限制公开访问,修复后关闭调试。若日志指向刚升级的插件,在后台停用它;后台打不开时可以临时改名该插件目录。
502 与 PHP-FPM
Nginx 或 OpenResty 返回 502 时,看上游日志里的连接拒绝、超时或 socket 不存在。检查站点使用的 PHP 服务是否启动、监听端口或 socket 是否与网站配置一致。
若错误是 Allowed memory size exhausted,确认网站 PHP 的 memory_limit 与服务器可用内存。只有明确发生内存耗尽时再调整配置,不把所有 502 都归结为内存。
修复后检查后台和文章
打开首页、文章、后台登录和图片,查看新日志是否还有相同错误。仅首页缓存能打开,不能说明 PHP 和数据库已恢复。
需要更换服务器时,保存日志与备份后按 WordPress 迁移教程操作。