json_decode()默认返回stdClass对象而非数组，需传true参数；中文编码需确保UTF-8；解析失败返回null，须用json_last_error()检测；深层嵌套受max_input_nesting_level限制。
json_decode() 默认只转成对象，不是数组
直接用 json_decode($json) 得到的是 stdClass 对象，不是你想要的关联数组。PHP 默认不自动转成数组，这是新手最常踩的坑——打印出来看着像数组，foreach 却报错“Invalid argument supplied for foreach()”，因为实际是对象。
必须显式传第二个参数 true：
$arr = json_decode($json, true);这样才返回嵌套的关联数组，支持
$arr['user']['id']、foreach ($arr['items'] as $item) 这类写法。
JSON 字符串含中文时要注意编码
如果原始 JSON 是 UTF-8 编码但含中文，而你的 PHP 文件或输出环境是 GBK，json_decode() 本身不会报错，但后续 echo 或写入数据库可能乱码。这不是函数问题，而是编码链断裂。
检查和修复建议：
• 用 mb_detect_encoding($json) 确认输入字符串确实是 UTF-8
• 如果是其他编码（比如 GB2312），先转码：$json = mb_convert_encoding($json, 'UTF-8', 'GB2312');
• 不要依赖 iconv()，它遇到非法字节容易静默失败；mb_convert_encoding() 更稳妥
json_decode() 失败时不报错，得手动检查
json_decode() 解析失败时默认返回 null，没有任何警告。如果你拿到的是 null 却没意识到解析失败，后续数组操作会出各种奇怪 Notice 或 Warning。
必须加错误检测：
• 先用 json_last_error() 判断：if (json_last_error() !== JSON_ERROR_NONE) { /* 处理错误 */ }
• 更推荐用 json_last_error_msg() 获取具体提示，比如 "Syntax error"、"Unterminated string"
• 常见诱因：前端 JS 用了单引号写 JSON、末尾多逗号、中文引号、BOM 头残留（尤其 Windows 记事本保存的文件）
深层嵌套数组性能没问题，但要注意递归深度限制
PHP 默认允许最大 512 层嵌套（由 max_input_nesting_level 控制，注意这不是 json_decode 的专属限制），普通业务 JSON 几乎不会触达。真遇到超深结构（比如某些配置导出、树形数据全量 dump），json_decode() 可能返回 null 且 json_last_error() 是 JSON_ERROR_DEPTH。
立即学习“PHP免费学习笔记（深入）”；
应对方式：
• 检查并调高 php.ini 中的 max_input_nesting_level（需重启 PHP-FPM / Apache）
• 更现实的做法是：前端避免生成过深 JSON；后端收到后先用 strlen($json) 和简单正则粗筛层级（如统计 { 数量），超过阈值直接拒收
• 不要用 eval() 或 create_function() 替代 —— 安全风险远大于深度问题
实际项目里，最常卡住人的不是语法，而是 JSON 字符串来源不可控：curl 返回体带隐藏 BOM、Vue 用 JSON.stringify() 但后端接收时被 Nginx 或代理截断了末尾、数据库字段类型是 TEXT 却存了超长 JSON 导致自动截断。这些地方出问题，json_decode() 都只会安静地返回 null。
