打开网站,一片空白,或者页面上只留下一行冷冰冰的“建立数据库连接时出错”。这种场景我见过太多次了。WordPress 本身没那么容易崩,真正让站长半夜爬起来抓狂的,往往是插件冲突、主题代码写崩了,或者服务器那边悄悄把 PHP 版本升了级。
上个月帮一个做手工皂的朋友看她的 WooCommerce 站。前台正常,后台一进订单页就白屏。她以为是主机的问题,换了服务器,重装了 WordPress,结果还是一样。我让她把插件目录整个改名,后台立刻能进了。再一个个恢复,最后锁定是一个用来做“满减赠品”的插件。那个插件最后一次更新是两年前,PHP 8.1 已经不支持它里面的一个函数写法。错误日志里其实写得很清楚:Fatal error: Uncaught Error: Call to undefined function mysql_connect()。只是她从来没看过那个文件。
WordPress 的错误大致分几类。PHP 层面的致命错误最直接,页面直接挂掉,通常伴随 500 状态码。数据库连接错误则是另一回事,多半是 wp-config.php 里的用户名、密码、主机地址不对,或者数据库服务本身没跑起来。还有一类是“白屏死机”,什么提示都没有,这时候得去 wp-config.php 里把 define('WP_DEBUG', true); 打开,才能看到具体报错。
很多人一遇到错误就去搜“WordPress 怎么修复”,然后照着教程改文件。改之前不备份,改完错误更多。有个读者曾经把 functions.php 里的一个分号删了,整站直接 500。他以为要重装,其实只要通过 FTP 把那个文件恢复就行。FTP 或者主机文件管理器,是处理 WordPress 错误的基本工具,比后台本身还重要——后台进不去的时候,只能靠它。
插件和主题的冲突占了错误的七成以上。判断方法很土但有效:把 wp-content/plugins 改名成 plugins_off,如果站点恢复正常,那就是插件问题。然后改回来,一个个重命名插件文件夹,刷新页面,直到找到那个惹事的。主题同理,把当前主题文件夹改名,WordPress 会自动切换到默认主题。这个办法笨,但不用懂代码。
内存不足是另一个高频问题。“Allowed memory size exhausted”这行字,意思是 PHP 分配给 WordPress 的内存用完了。在 wp-config.php 里加一行 define('WP_MEMORY_LIMIT', '256M'); 通常能解决。但如果是某个插件疯狂吃内存,加内存只是拖延,换插件才是正事。
数据库错误里,“Error establishing a database connection”最让人紧张。先别急着重装。去主机面板看看 MySQL 服务是不是停了。我有次遇到是主机商那边磁盘满了,数据库自动锁死。修复表可以用 phpMyAdmin,或者 WP-CLI 的 wp db repair。wp-config.php 里的 DB_HOST 有时候不是 localhost,而是类似 mysql.yourhost.com 的地址,改服务器后忘了更新这个,也会连不上。
错误日志比任何教程都有用。主机控制面板里一般有“错误日志”入口,或者直接看网站根目录下的 error_log 文件。里面会写清楚哪个文件、哪一行、什么错误。看不懂没关系,把那一行复制去搜,通常能找到具体原因。比盲目关插件快得多。
还有个小细节:WordPress 更新失败,比如“更新失败:无法创建目录”,多半是文件权限问题。wp-content 目录需要写权限,但权限给太高又不安全。755 给目录,644 给文件,这是比较稳妥的设置。有些主机用的是 www-data 用户,FTP 用户和它不一致,也会导致更新时权限报错。
说到底,WordPress 错误不是靠“一键修复”插件能解决的。那些插件自己就是错误来源。理解错误信息在说什么,知道去哪找日志,会通过 FTP 或文件管理器重命名文件夹,这三件事能解决大部分问题。剩下的,交给搜索引擎和耐心。