json_decode()返回null主因是输入JSON字符串不合法或编码非UTF-8，而非函数本身出错；需用json_last_error_msg()定位错误，并预处理BOM、控制符及转码。
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"
}
务必在调用后立即检查，否则无法定位具体问题。
立即学习“PHP免费学习笔记（深入）”；
传入了非字符串类型或空/空白内容
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 格式校验这一关。
