PHP json_decode为什么返回null-php教程-PHP中文网

json_decode()返回null主因是输入json字符串不合法或编码非utf-8，而非函数本身出错；需用json_last_error_msg()定位错误，并预处理bom、控制符及转码。

php json_decode为什么返回null

PHP 中 json_decode() 返回 null，通常不是函数出错，而是输入不符合 JSON 规范，或参数使用不当。PHP 在解析失败时**静默返回 null**（不会报错），容易让人误以为是代码问题，实际是数据本身不合法。

JSON 字符串本身格式错误

这是最常见原因。JSON 对语法极其严格：

必须用双引号包裹键名和字符串值，单引号无效（{'name': '张三'} ❌）
末尾不能有多余逗号（{"a":1, "b":2,} ❌）
不能有尾随小数点（3. ❌）、NaN、Infinity（PHP 默认不支持）
中文等 Unicode 字符需正确编码（UTF-8），含 BOM 或乱码会导致解析失败
换行/缩进本身不影响，但混入不可见控制字符（如 U+0000、U+2028）会中断解析

未检查 json_last_error() 和 json_last_error_msg()

PHP 不抛异常，但提供诊断工具：

$data = json_decode($json, true);
if ($data === null && json_last_error() !== JSON_ERROR_NONE) {
    echo '解析失败：' . json_last_error_msg(); // 如 "Syntax error"、"Malformed UTF-8 characters"
}

务必在调用后立即检查，否则无法定位具体问题。

抖音下载器(Node.js)

抖音无水印视频下载和文案提取工具

下载

传入了非字符串类型或空/空白内容

json_decode() 要求第一个参数是字符串：

传入 null、false、数组或资源 → 直接返回 null
传入空字符串 '' 或纯空白（"\t\n "）→ 返回 null
从 $_POST、file_get_contents() 等获取数据前，先 trim() 并确认非空

编码问题：非 UTF-8 字符集

JSON 标准只允许 UTF-8 编码。如果原始数据是 GBK、ISO-8859-1 等：

中文会变成乱码，导致解析失败
可用 mb_convert_encoding($json, 'UTF-8', 'AUTO') 尝试自动转码
更稳妥的是确保源头（如前端 fetch、curl 请求头）明确声明 Content-Type: application/json; charset=utf-8

不复杂但容易忽略 —— 多数 null 返回，其实只是字符串没过 JSON 格式校验这一关。