PHP json_decode 返回 null 但 json_last_error 是 0,字符串里有隐藏字符怎么排查

现象:json_deCode 返回 null,错误码却是 0

接口里拿到一段 JSON 字符串,json_decode 之后是 null,按惯例调 json_last_error() 想看看哪错了,结果返回 0 也就是 JSON_ERROR_NONE,让人摸不着头脑。其实错误码为 0 只说明解析器没抛出语法错误,并不代表输入就是合法 JSON,常见原因是字符串里藏了不可见字符。

第一步:先看字符串的原始字节

直接 echo 看不出问题,用 bin2hex 或 ord 逐字符打印,重点查开头有没有 EF BB BF 这三个字节,那是 UTF-8 的 BOM,会让解析器在第一个字符就判定不是 JSON 但又不算语法错误:

echo bin2hex(substr($str, 0, 3));  // 输出 efbbbf 就是带 BOM

第二步:去掉 BOM 和首尾空白

trim 只能去普通空白,去不掉 BOM。要先把 BOM 三字节干掉再 trim,然后再解码:

$str = preg_replace('/^\xEF\xBB\xBF/', '', trim($str));
$data = json_decode($str, true);

第三步:用 JSON_THROW_ON_ERROR 拿到真实异常

PHP 7.3 之后给 json_decode 加 JSON_THROW_ON_ERROR,解析失败直接抛 JsonException,message 里会写明是哪一类问题,比反复猜错误码靠谱得多:

try {
    $data = json_decode($str, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
    echo $e->getMessage();  // 例如 "State mismatch (invalid or malformed JSON)"
}

第四步:警惕深度和数字精度

嵌套超过默认 512 层会返回 null,传第四个参数加大深度即可。另外 JSON 里的大整数超过 PHP_INT_MAX 会被转成浮点数精度丢失,需要时加 JSON_BIGINT_AS_STRING 按字符串保留。

验证

改完重新解码,var_dump 看返回是不是预期数组。如果还是 null,用 json_last_error_msg() 替代数字错误码,它会返回英文描述,比 0 有信息量得多。接口联调时建议默认带上 JSON_THROW_ON_ERROR,把静默失败改成显式异常。

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