json_decode返回null的五大原因及修复步骤：一、检查JSON语法合法性并用json_last_error()定位错误；二、验证并转换为UTF-8编码，清除BOM；三、确认字符串未被截断；四、移除不可见控制字符；五、禁用@错误抑制符。
PHP 中 json_decode() 返回 null，不是函数坏了，而是输入数据或调用方式踩中了几个典型“雷区”。只要按顺序排查，90% 的问题当场定位、立刻修复。
语法不合法：双引号、逗号、转义一个都不能错
JSON 标准极其严格：必须用双引号包裹键和字符串值，不能有末尾逗号，所有特殊字符（如换行、引号）必须正确转义。
- ❌ 错误示例：
{"name": 'Alice'}（单引号）、{"id": 1,}（尾随逗号）、{"msg": "hello world"}（未转义换行） - ✅ 正确写法：
{"name": "Alice", "id": 1, "msg": "hello\nworld"} - 调试建议：把 JSON 字符串复制到在线校验工具（如 jsonlint.com）验证；或在 PHP 中立即调用
json_last_error_msg()，若返回"Syntax error"，基本就是这里出问题。
编码不是 UTF-8：BOM、GBK、乱码全会静默失败
json_decode() 只接受合法 UTF-8 编码的字符串。哪怕只多一个 BOM 头（），或混入 GBK 字符，解析就会返回 null，且错误提示常是模糊的 "Control character error" 或 "Malformed UTF-8 characters"。
- 先检测编码：
mb_detect_encoding($json, ['UTF-8', 'GBK', 'BIG5'], true) - 强制转 UTF-8：
$json = mb_convert_encoding($json, 'UTF-8', $detected) - 清除 BOM：
$json = ltrim($json, "") - 小技巧：用
bin2hex(substr($json, 0, 3)) === 'efbbbf'快速判断是否存在 UTF-8 BOM。
嵌套太深：默认 512 层，超了就 null，不报错
这是最隐蔽的坑——JSON 看似完全合法、编码也没问题，但结构嵌套超过 512 层（比如树形配置、递归生成的数据），json_decode() 就会直接返回 null，错误码为 JSON_ERROR_DEPTH。
立即学习“PHP免费学习笔记（深入）”；
- 确认方式：调用后检查
json_last_error() === JSON_ERROR_DEPTH - 解决方法：显式传入更大的
$depth参数，例如json_decode($json, true, 1024) - 注意：深度值必须大于 0 且 ≤ 2147483647；PHP 8+ 对非法 depth 值会抛
ValueError，不再是警告。
字符串被截断或污染：看不见的空格、换行、HTML 标签
从表单提交、curl 响应、数据库读取来的 JSON，容易夹带不可见字符：前后空格、制表符、回车、甚至 HTML 实体或 JS 注入残留。
- 常见污染源：前端用
JSON.stringify()后又拼接了 HTML；后端从$_POST或file_get_contents('php://input')读取时未清理 - 基础清理：
$json = trim($json); - 强化过滤（谨慎使用）：
$json = preg_replace('/[ - - ]/u', '', $json);（移除控制字符） - 验证完整性：检查结尾是否为
"}"或"]"，用strlen()对比预期长度。
