现象:页面缺数据,日志里刷满 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); 和函数的可空返回类型声明,同类问题在编码阶段就会暴露。
