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 官网。遇到搞不定的报错也别硬扛,备份在手、主机商可联系,网站很快就能回来。




