现象
调用第三方接口拿到响应后 json_deCode 返回 null,json_last_error 的值是 4,对应 JSON_ERROR_SYNTAX。把同一段字符串复制到在线格式化工具却能正常解析,肉眼也看不出缺引号或括号,接口在浏览器里显示正常。
原因
语法错误的来源往往在看不见的字符:响应开头带 UTF-8 BOM,字段里有未转义的换行或制表符,末尾多了逗号,或者返回的根本是 HTML 错误页而不是 JSON。另一种情况是响应被 gzip 压缩但没解压,二进制内容当然解析失败。json_last_error 还会被后续的 json_encode 调用重置,打印时机不对也会误判。
解决步骤
第一步,检查原始字节。打印前三个字节的十六进制,BOM 是 efbbbf;同时看 Content-Type 和 Content-Encoding,确认内容类型和压缩方式。
$raw = file_get_contents('https://api.example.com/data');
var_dump(bin2hex(substr($raw, 0, 3)));
var_dump(substr($raw, 0, 200));
第二步,清理后再解析。去掉 BOM 和首尾空白,用 JSON_THROW_ON_ERROR 让异常直接抛出,避免拿到 null 继续往下跑。
$raw = ltrim($raw, "\xEF\xBB\xBF");
try {
$data = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
error_log($e->getMessage());
}
第三步,处理压缩和错误页。curl 场景把 CURLOPT_ENCODING 设为空字符串让扩展自动解压;file_get_contents 则检查响应头状态码,4xx、5xx 时不要当 JSON 解析,先记录原始内容。
验证
json_decode 返回数组,json_last_error 为 0,字段数量与文档一致;异常分支能打印出具体位置,不再出现静默的 null。
小结
语法错误先看字节和响应头,BOM、压缩、错误页是三座大山。解析时开启异常模式,比事后猜 null 高效得多。
