PHP 8 报 Trying to access array offset on value of type null 怎么改

现象:页面缺数据,日志里刷满 warning

项目从 PHP 7.2 升到 8.x 之后,日志里反复出现 Warning: Trying to access array offset on value of type null in /www/app/list.php on line 42,前台表现为某些字段空白,部分列表直接少了几行,但页面本身不报 500。

原因:拿 null 当数组用了

PHP 7.4 起,对 null 取数组下标从 notiCe 提升为 warning,8.0 之后走的是同一条告警路径。真正的问题不是这条提示,而是变量为什么是 null:

  • json_decode() 解析失败返回 null,代码却直接取 $data['list'];
  • PDO::fetch() 查不到记录返回 false,继续按数组取字段;
  • 函数漏写 return,调用方拿到 null 还去取键;
  • 请求参数没传,$_GET['page'] 不存在时先报 undefined index,再取下标就是 null。

解决步骤

第一步,先定位来源,在报错行上方打印变量,确认是空结果还是解析失败:

var_dump($row);
$name = $row['name'] ?? '';

第二步,用空合并运算符兜底,这能消掉告警,但只是止血,必须同时确认业务语义上空值是否可接受。

第三步,按类型做判断,查库结果和接口返回都要先判断再取值:

if (!is_array($row)) {
    return [];
}
$data = json_decode($json, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    throw new RuntimeException(json_last_error_msg());
}

第四步,改掉"取不到就继续用"的写法。fetch() 返回 false 时直接 continue,不要进入字段处理逻辑;参数入口统一用 filter_input 或框架的验证层,缺参就提前返回 400。

小结

这条 warning 是症状不是病根,根因是空值没有被处理。用 ?? 可以先让日志安静,但真正的修法是在数据来源处判断类型和错误码。

升级期间建议在 CI 里跑一遍静态分析,PHPStan 或 Psalm 设到 level 5 以上,就能在提交前把"可能为 null"的调用点全部标出来,不用等线上日志。再配合 declare(strict_types=1); 和函数的可空返回类型声明,同类问题在编码阶段就会暴露。

您可以还会对下面的文章感兴趣: