现象: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,把静默失败改成显式异常。
