一、常见的 PHP 8 报错类型
B2 主题早期版本基于 PHP 7 开发，迁移到 PHP 8 后常见以下 Warning/Deprecated 报错，虽然多数不影响功能，但会在页面顶部输出，影响体验与 SEO。
二、Undefined array key（未定义数组键）
例如 B2 主题数字缩写函数中出现的 Warning: Undefined array key 5：
Text
<?php
// 修复思路：使用 ?? 或 isset() 做兜底
$suffix = $keys[ $index ] ?? '';
排查方法：根据报错提示的文件与行号，找到数组取值处，加上空值判断即可。
三、foreach() argument must be of type array|object
当后台某个选项未配置（返回空字符串）时，直接 foreach 遍历会报错：
Text
<?php
// 错误写法
foreach ( $cats as $k => $v ) { ... }
// 正确写法：先判断是否为数组
if ( is_array( $cats ) && ! empty( $cats ) ) {
foreach ( $cats as $k => $v ) { ... }
}
四、动态属性 Deprecated（PHP 8.2）
PHP 8.2 中给对象动态添加属性会触发 Deprecated 警告（如 CSF 选项框架的字段类）。修复方式是为类显式声明属性，或改用数组存储动态数据：
Text
<?php
class My_Field {
public $name;
public $value;
// 显式声明需要的属性，避免动态创建
}
五、Trying to access array offset on bool
函数返回 false（如查询无结果）后直接当作数组取值时报错，修复：
Text
<?php
$opt = get_option( 'xxx', array() );
$val = is_array( $opt ) && isset( $opt['key'] ) ? $opt['key'] : '';
六、系统排查建议
1. 开启 WP_DEBUG 定位报错文件与行号：
Text
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
2. 按报错行号逐一修复，先修”数组/空值判断”，再修”动态属性”类问题。
3. 修复后关闭 WP_DEBUG 输出，避免暴露敏感信息。