PHP json_decode 返回 null 怎么排查?先看 json_last_error_msg

现象

用 PHP 的 json_deCode 解析接口返回或本地 JSON 文件时,结果一直是 null,var_dump 出来还是 null,页面也不报任何错误。更迷惑的是,同样的代码在本地正常,换到测试环境就失败。很多人卡在这一步只能反复 var_dump,不知道从哪里查起。

原因

json_decode 的设计是“安静失败”:遇到不合法的输入时不抛异常也不写日志,只返回一个 null,真正的错误码被压在 json_last_error() 里,不主动去取就等于盲猜。常见失败原因集中在四类:

  • JSON 语法不合法。标准只允许双引号,不允许尾逗号和注释,自己手工拼接的字符串最容易中招;
  • 输入带了 BOM 头。Windows 下部分编辑器保存文件时会自动加上 BOM,肉眼看不见,json_decode 却会直接判定为语法错误;
  • 编码不是 UTF-8。JSON 标准要求输入必须是 UTF-8,GBK 编码的中文字符串直接丢进去必然失败;
  • 嵌套层级超过默认的 512 层,深层结构解析到一半被截断。

解决步骤

第一步:先让错误信息现形

判断结果必须用全等比较,配合 json_last_error() 才能区分“内容本来就是 null”和“真的解析失败”:

$data = json_decode($json);
if ($data === null && json_last_error() !== JSON_ERROR_NONE) {
    echo json_last_error_msg();  // 例如:Syntax error
}

第二步:核对语法是否符合 JSON 标准

接口返回的 JSON 一般没问题,出问题最多的是自己拼出来的字符串,重点检查单引号和尾逗号:

$bad = "{'name': 'abc', 'age': 18,}";  // 单引号 + 尾逗号
var_dump(json_decode($bad));            // 输出 null

第三步:清理 BOM 和不可见字符

清理后如果仍失败,用 bin2hex 打印文件头,看有没有多余的不可见字节:

$json = preg_replace('/^\xEF\xBB\xBF/', '', $json);
$json = trim($json);
echo bin2hex(substr($json, 0, 8));

第四步:统一转成 UTF-8 编码

数据源头是 GBK 或从旧系统导出时,先转码再解析:

$json = mb_convert_encoding($json, 'UTF-8', 'GBK');

第五步:让 PHP 7.3+ 直接抛异常

与其每次手动检查错误码,不如开启 JSON_THROW_ON_ERROR,让失败立刻报错:

try {
    $data = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
    echo $e->getMessage();
}

小结

json_decode 返回 null 并不神秘,json_last_error_msg() 会直接告诉你失败原因。日常编码记住三点:只用双引号、不写尾逗号、编码统一 UTF-8;PHP 7.3 以上建议默认开启 JSON_THROW_ON_ERROR,让问题在第一现场暴露,而不是等 null 传到下游再层层排查。

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