本文约 2,468 字，预计阅读 7 分钟。文中命令与配置均经过实测，可直接参考执行。
引言
主机商在后台提示「PHP 7.4 已停止安全支持，建议升级」，你顺手把版本切到了 PHP 8.1 或 8.2，结果网站出了问题：前台报出 Fatal error、Deprecated 警告刷屏，或者主题的某些功能直接失效、版式错位。这是近年最典型的兼容性故障——PHP 8 大幅收紧了语法，很多老旧主题里「能跑但写法不严谨」的代码都会暴露问题。遇到这种情况，不必立刻推倒重来，可以按「先保站点、再修主题、后定策略」的思路处理：要么临时降回兼容版本稳住业务，要么修好主题代码，要么干脆换一个官方声明兼容 PHP 8 的主题。需要提醒的是，PHP 8 真正”踩雷”的，往往是那些作者早已停更、写法陈旧的老主题；越是长期没更新的主题，越容易在这一步暴露问题。
故障原因分析
- 过时函数被移除：PHP 8 移除了
each()、create_function()等老函数，主题一调用就致命错误。 - 类型与参数更严格：向要求数组的函数传 null、字符串拼接数字等写法，在 PHP 8 会抛
TypeError或警告。 - 未定义变量／数组键直接使用：以前只提示 Notice，PHP 8 变成 Warning，配合严格显示就会打乱页面。
- 动态属性（Dynamic Properties）弃用（PHP 8.2）：类里未声明的属性赋值会触发 Deprecated 警告。
- 主题年久失修：作者早已停止维护，没有针对 PHP 8 发布兼容版本。
- 插件与主题叠加：有时是主题里引用的某个插件/库不兼容，报错却指向主题文件。
分步解决方案
方法一：临时降级 PHP 版本，先让站点恢复
如果业务不能停，最快的做法是先切回兼容版本（如 PHP 7.4 或 8.0），把站点救活，再从容修主题。
- 宝塔面板：网站 → 设置 → PHP 版本，选择目标版本并「切换」；
- cPanel：MultiPHP Manager 里给域名选版本；
- 云主机/虚拟主机：一般在主机商控制台的「PHP 设置」中切换。
降级只是应急，长期停在停止支持的版本会有安全风险，务必尽快回到 PHP 8。
方法二：定位并修复具体的过时写法
先开启日志，方法是在 wp-config.php（站点根目录，父/子主题共用同一份配置）中加入：
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );刷新出错页面后查看 wp-content/debug.log，日志会指出文件名与行号。常见的几类修法：
// 1) each() 已移除，改用 foreach
// 旧写法：while ( list( $k, $v ) = each( $arr ) ) { ... }
foreach ( $arr as $k => $v ) { /* ... */ }
// 2) create_function() 已移除，改用匿名函数
// 旧写法：$cb = create_function( '$x', 'return $x * 2;' );
$cb = function ( $x ) { return $x * 2; };
// 3) 调用前先判空，避免传 null 触发 TypeError
$items = get_option( 'my_items', array() );
if ( is_array( $items ) ) { /* 安全使用 */ }务必改在子主题里：把父主题需要修改的文件复制到 wp-content/themes/你的子主题/ 相同路径下再改，否则父主题一更新就白改。
方法三：关闭报错显示，先稳住前台
若错误只是 Warning/Notice 级别在污染页面，可先隐藏显示（仍写日志）：
@ini_set( 'display_errors', 0 );这只能遮住「表面」，不能真正修复，别把它当成最终方案。生产环境通常把 WP_DEBUG 设为 false 也能让页面不再输出警告。
方法四：换用声明兼容 PHP 8 的主题
如果主题作者已停止维护、报错成片修不完，果断换主题更省心。选主题时看它的「Tested up to」与更新日期，优先选择近半年内更新、明确写支持 PHP 8.x 的主题。换主题前先备份，切换后按菜单、小工具、首页模板重新配置。
方法五：用工具批量扫描不兼容点
如果站点装了较多插件、主题代码量又大，逐个手改效率很低。可以用 PHP_CodeSniffer 配合 PHPCompatibility 规则集做一次静态扫描，它会列出所有命中不兼容写法的文件与行号，帮你快速圈定”重灾区”。静态扫描不能替代运行时验证，但能让你对修复工作量心里有数，从而决定到底是修还是换。
常见踩坑点
- 直接把整个站点的错误显示打开给别人看：会暴露服务器路径与数据库结构，排查完立刻关掉。
- 在父主题里改代码：更新即覆盖，一定要改子主题。
- 降级 PHP 后就不管了：旧版本不再有安全补丁，属于慢性隐患。
- 用
@压制所有报错：会盖住真正的致命错误，导致更难定位。 - 只改主题不看插件：有时报错源头在插件，要顺藤摸瓜。
- 忘了清 opcache：改完 PHP 版本或代码后没清 opcache，旧缓存让人误判”没生效”。
总结
主题不兼容 PHP 8 报错，处理的关键是分清「应急」与「根治」：先用切换 PHP 版本或隐藏显示把站点救活，再借调试日志定位到具体函数与行号，用 foreach 替代 each、用匿名函数替代 create_function、补上判空等手法逐条修复，改在子主题里以免被覆盖；实在修不动，就换一个明确兼容 PHP 8 的主题。整个过程中，坚持备份、及时清理缓存、尽快回到受支持的 PHP 版本，这样主题不兼容 PHP8 的报错才不会反复困扰你，站点也能平稳跟着 PHP 一起升级。
