现象
用 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 传到下游再层层排查。
