WordPress 网站出问题,最让站长慌的三类错误是:打开一片空白、页面显示 500 Internal Server Error、以及那句著名的 Error Establishing a Database Connection。这三类问题看似吓人,绝大多数都有固定的排查路径,按步骤走十几分钟就能恢复。这篇教程以 WordPress.org 官方常见错误文档 与 2026 年最新的排查实践为基础,把白屏、500、数据库错误以及连带的高频问题逐一讲清。

诊断前置:先打开调试模式

WordPress 默认隐藏错误信息,所以白屏才显得神秘。排查任何问题前,先在 wp-config.php 中添加三行配置开启调试:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

这样错误会写入 wp-content/debug.log 而不是直接显示给访客,既能拿到报错线索又不影响用户体验。复现问题后打开 debug.log,里面会明确指出出错的插件、主题或核心文件,很多问题在这一步就锁定了凶手。问题解决后记得移除或改回这三行,避免线上长期开启调试。编辑 wp-config.php 需要在文件管理器或 FTP 中进行,Hostinger 的文件管理操作见 hPanel 后台使用完整教程。没有条件开调试时,直接看主机面板的错误日志也能拿到相同信息,两类日志互相印证排查更快。

错误速查表

动手前先对照下表确定问题类型,不同错误走不同的排查路径,避免盲目试错:

现象最常见原因优先处理
白屏无提示插件/主题冲突、内存耗尽开调试、停插件
500 Internal Server Error.htaccess 损坏、PHP 内存重置 .htaccess
数据库连接错误wp-config 凭据错误、数据表损坏核对四项配置
登录循环Cookie、缓存、站点地址错误清 Cookie 与缓存
403 禁止访问.htaccess 规则、权限错误检查规则与目录权限
404 页面打不开伪静态失效、mod_rewrite 未开重置固定链接
图片上传失败目录权限、内存、格式限制检查 uploads 权限

白屏死机(WSOD):最常见的原因与修复

白屏死机指页面完全空白、无任何提示,通常是 PHP 致命错误导致,插件冲突与主题问题是两大主因,其次是 PHP 内存耗尽。修复按优先级推进:

排查步骤操作适用场景
1. 看 debug.log按上文开启调试后复现问题,读取错误记录所有白屏
2. 停用全部插件通过 FTP 把 wp-content/plugins 改名为 plugins_old后台进不去时
3. 逐个恢复插件恢复目录名后后台逐个启用、逐个测试定位冲突插件
4. 切换默认主题把当前主题目录改名,WordPress 自动回退默认主题刚换主题后白屏
5. 提高 PHP 内存wp-config.php 添加 define( 'WP_MEMORY_LIMIT', '256M' )内存耗尽报错

后台还能登录时,直接在插件列表批量停用再逐个启用更快;后台也进不去时,通过文件管理器重命名插件目录即可。恢复后如果确认是内存问题,再评估是否插件本身存在性能缺陷——单纯提高内存只能缓解,长期要替换内存大户插件。Hostinger 的 PHP 版本与配置调整方法见 PHP 版本切换教程。

500 内部服务器错误:按四步排查

500 错误意味着服务器端出了状况,但页面不会告诉你具体原因。按官方文档与主流排查实践,最常见的原因是 .htaccess 文件损坏,其次是插件或主题问题、PHP 内存不足与文件权限异常。排查顺序:

第一步,重置 .htaccess:通过文件管理器把根目录的 .htaccess 改名为 .htaccess_old,然后刷新网站;若恢复正常,进入后台设置、固定链接,点保存更改重新生成一份干净的 .htaccess。第二步,停用全部插件与切换默认主题(方法同白屏章节),排除代码冲突。第三步,检查文件权限:目录应为 755、文件应为 644,wp-config.php 建议 600,发现 777 的目录立即收紧——过宽的权限本身也是安全风险。第四步,查看服务器错误日志:Hostinger 的 hPanel 提供错误日志入口,能看到 Apache 或 PHP 层级的真实报错,比盲猜快得多。做完这四步,绝大多数 500 都能定位。.htaccess 的高级规则写法参考 .htaccess 配置教程。

数据库连接错误:先查配置再查服务

Error Establishing a Database Connection 通常由三类原因引起:wp-config.php 里的数据库信息错误、数据库服务不可用、数据表损坏。第一步检查配置文件中的四项内容,必须与主机面板完全一致:

配置项对应内容错误典型表现
DB_NAME数据库名称迁移后忘记更新
DB_USER数据库用户名用户名前缀改动
DB_PASSWORD数据库密码密码重置后未同步
DB_HOST数据库主机默认 localhost 不匹配

第二步用 phpMyAdmin 用同一组凭据尝试登录,能进说明配置问题,进不去则重置数据库密码并同步到 wp-config.php。第三步确认数据库服务本身正常,共享主机上数据库配额耗尽或服务重启也会导致连接失败,这种情况联系主机商处理。第四步,若配置与服务都正常但依旧报错,可能是数据表损坏,使用 WordPress 内置修复工具:在 wp-config.php 临时添加 define( 'WP_ALLOW_REPAIR', true ),访问 域名/wp-admin/maint/repair.php 点击修复,完成后立即删除该行——这个开关无需认证,留着等于给任何人开放修复入口。Hostinger 的数据库管理全流程见 数据库管理教程。

连带问题:登录循环、403 与 404

修复主错误后经常碰到几个连带问题。登录循环:输入密码后跳回登录页,通常是 cookie 问题、缓存插件缓存了登录页,或数据库里 siteurl 与 home 设置与真实地址不一致,清浏览器 cookie、清站点缓存、核对 wp_options 表里的两项地址即可。403 权限错误:多为 .htaccess 规则误写或目录权限过窄,检查规则与权限。404 与伪静态失效:固定链接打不开一般是 .htaccess 缺失或未开启 mod_rewrite,重置固定链接即可恢复。国内访问时如果出现超时或无法打开,先按 网站国内打不开自查清单 排查网络链路,再回到本文处理具体报错。

恢复后的预防清单

错误修完不等于万事大吉,建议按清单防复发:开启自动化备份并定期演练恢复,Hostinger 备份操作见 备份与恢复教程;控制插件数量,删除不再使用的插件;更新前先在测试环境验证,重要站点避开业务高峰期更新;保持 PHP 版本与 WordPress 核心同步更新;出现规律性报错时检查错误日志,把隐患消灭在爆发前。备份是最后一道保险,宁可多备不可不备。把每次排障的根因记下来,同一类错误再次出现时直接按历史方案处理,二次排障时间能缩短一半。

何时该求助主机商

排查到数据库服务层、服务器配置层时,就到了联系主机商的边界:数据库配额耗尽、服务器重启、PHP 版本不兼容等都需要主机侧处理。Hostinger 的工单支持与帮助中心响应及时,沟通时附上错误日志截图能显著加快解决速度。如果你正在考虑迁入或更换主机,套餐选择参考 共享主机评测 与 8 大套餐对比。

PHP 内存耗尽:报错信息直接点名

内存耗尽(Allowed memory size ... exhausted)的错误信息会直接指出消耗内存的插件与文件,排查起点非常明确。快速解法是在 wp-config.php 添加 define( 'WP_MEMORY_LIMIT', '256M' ) 与 define( 'WP_MAX_MEMORY_LIMIT', '512M' ),前者管前台、后者管后台;也可以在 php.ini 或 .htaccess 里设置 memory_limit,但 .htaccess 方案在 Nginx 环境不生效,主机面板的 PHP 设置是通用路径。提高上限只是争取时间,真正的解法是找出内存大户:页面构建器渲染复杂页面、WooCommerce 大查询、备份插件在 PHP 内存里打包全站,都是常见元凶,替换或优化后问题才会根治。用 Query Monitor 这类插件能看到每次请求的 PHP 内存消耗,逐个页面排查。

图片上传失败与媒体错误

媒体库上传图片失败通常有四种原因:wp-content/uploads 目录权限不足,检查目录与文件权限(目录 755、文件 644),并确认属主正确;PHP 上传大小限制,post_max_size 与 upload_max_filesize 默认值较小,在主机面板调大;内存不足,压缩大图时消耗内存,按上文提高 WP_MEMORY_LIMIT;图片格式或尺寸问题,超大尺寸原图建议先压缩再上传。上传失败的日志同样记录在 debug.log 与主机错误日志中,对照报错再动手。图片加载慢的优化方案见 图片加载慢 WebP 优化,从源头控制图片体积能减少这类问题。

维护模式卡住与调试信息残留

站点显示"Briefly unavailable for scheduled maintenance"且几分钟后不消失,通常是更新中断导致 .maintenance 文件残留:通过文件管理器删除 WordPress 根目录的 .maintenance 文件即可恢复。另一个高频小问题是 Cannot modify header information - headers already sent,一般是某个 PHP 文件在标签前后有空格或 BOM 字符,用编辑器检查报错文件,清除多余输出即解决。还有调试信息残留:WP_DEBUG 开着、debug.log 公开可访问都属于隐患,排查完成后务必关闭调试并确认 debug.log 不可公网访问。

伪静态与固定链接详解

文章页、分类页 404,通常是伪静态规则失效:检查根目录 .htaccess 是否存在且包含 WordPress 标准重写规则,没有就重新保存一次固定链接(设置、固定链接、保存更改)自动生成;Hostinger 面板要确认 mod_rewrite 已开启;Nginx 环境则检查 nginx 配置里的 try_files 规则。新建文章打不开但首页正常,也优先排查这一步。.htaccess 的结构与写法详解见 .htaccess 配置教程,伪静态与部署相关的问题也可以参考 Git 部署教程 中的服务器配置章节。

从备份恢复:最后的保险

当排查无果或网站已被严重破坏,从备份恢复是最快的出路:先在 hPanel 创建或确认最近的备份存在,Hostinger 的备份与恢复流程见 备份与恢复教程;恢复到站点的操作分两步,先恢复文件,再恢复数据库;恢复完成后清一遍缓存,检查关键页面与插件设置。备份恢复会丢失备份时间点之后的数据,所以日常保持自动备份频率,电商站点建议至少每日一次。恢复演练很有价值——每个月在测试环境做一次完整恢复,确保备份真正可用,而不是等到出事才发现备份是坏的。

FAQ:高频疑问速答

问:为什么白屏但后台能进?答:说明前台模板或前台加载的插件出错,按停插件、切主题的顺序排查。问:500 错误间歇出现?答:多为资源型问题,看主机错误日志里是否有内存或超时记录,同时检查是否某个时段流量高峰触发。问:数据库连接错误会不会丢数据?答:几乎不会,绝大多数是连接问题而非数据丢失,数据表损坏也可通过修复工具恢复。问:更换 PHP 版本能不能解决 500?答:有时可以,老插件不兼容新版本会触发错误,降级或升级 PHP 都可能解决问题,版本切换方法见 PHP 版本切换教程。问:错误日志在哪里看?答:WordPress 层面看 wp-content/debug.log,服务器层面看 hPanel 的错误日志入口,两处配合使用。

总结

WordPress 三类高频错误都有标准解法:白屏优先查插件冲突与内存,500 优先重置 .htaccess 与查错误日志,数据库错误优先核对 wp-config 与数据表修复。开调试、看日志、按步骤隔离,是万能的排查心法,配合备份兜底就能把故障时间压缩到分钟级。购买 Hostinger 主机时使用优惠码 1RAY132 可享 20% 折扣,结算页填写即生效;直达购买页可用推荐链接 Hostinger 官网。遇到搞不定的报错也别硬扛,备份在手、主机商可联系,网站很快就能回来。