现象
在 WordPress 5.9 后台点安装插件并启用,前台整站立刻变成一片白,浏览器状态码是 200,查看源码只有几个空行,后台同样打不开。翻 wp-Content/debug.log,最后一行是 Fatal error: Cannot redeclare get_avatar(),把插件目录改名之后站点马上恢复。
原因
白屏本质是 PHP 致命错误,只是 display_errors 被关掉,所以页面上什么都看不到。最常见的是两个插件声明了同名函数或同名类,后加载的那个直接报 Cannot redeclare;其次是插件用了 PHP 8 已经移除的函数或语法;插件与主题的加载顺序不一致也会触发。
解决步骤
第一步,让错误先显示出来。在 wp-config.php 里打开调试开关,把错误写进日志而不是输出到页面,避免把服务器路径暴露给访客。
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
mv wp-content/plugins wp-content/plugins_bak
第二步,强制停用全部插件确认范围。把 plugins 目录改名后 WordPress 会自动停用所有插件,能进后台说明问题确实出在插件侧;把目录改回来,再一个一个启用,谁启用后白屏谁就是元凶。
第三步,按函数名找到重复声明。拿到日志里的函数名,用 grep 在两个插件目录里搜索同名声明,优先升级到支持 5.9 的新版本;实在没有更新,就只保留其中一个,或用子主题加 if (!function_exists()) 包一层。
验证
再次访问首页与后台,页面正常渲染,debug.log 不再新增 Fatal error,插件全部启用时也能正常发布文章。
小结
白屏并不神秘,先打开错误日志是唯一正确的起点。确认是插件冲突后,用目录改名法快速缩小范围,再按函数名找重复声明,比一个个猜要快得多。
