根本原因只有一个：输入字符串不满足JSON解析器的严格要求。常见原因包括JSON语法不合法（如单引号、尾随逗号）、非UTF-8编码或含BOM/控制字符、字符串被截断、嵌套超深（默认512层）等，均导致json_decode静默返回null。
PHP 的 json_decode() 解析失败，**根本原因只有一个：输入字符串不满足 JSON 解析器的严格要求**。它不会“尽力而为”，而是完全拒绝任何偏差——哪怕一个空格、一个逗号、一个编码字节不对，都会直接返回 null，且默认不报错。
JSON 格式不合法是最常见原因
PHP 要求输入必须是 RFC 8259 完全合规的 JSON 字符串，常见违规包括：
- 用单引号代替双引号，例如
{'name': '张三'}→ 必须写成{"name": "张三"} - 对象或数组末尾多了一个逗号，例如
{"a": 1,}或[1,2,] - 字符串未闭合，比如缺少结尾的双引号：
{"msg": "hello - 键名没加引号（JavaScript 允许，JSON 不允许）：
{name: "test"} - 包含 JavaScript 注释
//或/* */，JSON 标准不支持注释
编码不是 UTF-8 或含非法字符
json_decode() 强制要求输入为合法 UTF-8 编码。以下情况会导致静默失败：
- 字符串实际是 GBK/GB2312 编码，但没转换就直接解析
- 文件或响应开头存在 UTF-8 BOM（
\xEF\xBB\xBF），需用ltrim($json, "\xEF\xBB\xBF")清除 - 混入不可见控制字符，如
\0、\t、\r、\n（尤其在用户输入或日志拼接场景） - 中文等非 ASCII 字符被截断或乱码，形成非法 UTF-8 序列
字符串被意外截断或损坏
从外部来源获取 JSON 时，常因中间环节出错导致结构不完整：
立即学习“PHP免费学习笔记（深入）”；
- cURL 响应未读完、超时中断，或
Content-Length与实际不符 - 数据库字段类型长度不足（如
VARCHAR(255)存长 JSON），自动截断末尾 - PHP 输出缓冲限制（
output_buffering）、max_input_vars等配置影响 POST 数据接收 - 查看字符串结尾：
substr($json, -5)，确认是否以"}"或"]"结束
嵌套过深或超出配置限制
PHP 默认限制 JSON 最大嵌套深度为 512 层。若数据结构异常复杂（如递归生成、前端误传），会触发 JSON_ERROR_DEPTH 错误：
- 调用后检查
json_last_error() === JSON_ERROR_DEPTH - 可通过
ini_set('max_nesting_level', 1024)临时提高（需权衡安全与内存） - 更稳妥做法是服务端预校验或前端简化结构，避免依赖调高限制
