json_decode解析空字符串或null会失败并返回JSON_ERROR_SYNTAX；需先trim判断空、再配合json_last_error()校验；默认返回对象，数组访问须传true；注意BOM、嵌套深度限制及统一数据结构。
json_decode 解析空字符串或 null 值会失败
直接对空字符串 "" 或 PHP 的 null 调用 json_decode()，结果是 null，且 json_last_error() 返回 JSON_ERROR_SYNTAX。这不是 bug，而是设计：JSON 规范里空字符串根本不是合法 JSON。
常见于 HTTP 请求未返回内容、cURL 超时后返回空响应体、或前端传了空 body 的场景。
- 调用前先用
trim()清理空白，再判断长度：if (trim($json) === '') { /* 处理空 */ } - 不要依赖
json_decode($json) === null判断失败——它也可能是合法 JSON 解析出的null，务必配合json_last_error() === JSON_ERROR_NONE - 若上游可能返回空，建议统一兜底：
$data = $json ? json_decode($json, true) : [];
json_decode 第二个参数设为 true 才返回数组，否则是对象
json_decode() 默认返回 stdClass 对象，不是关联数组。很多开发者忘记传 true，结果写 $data['key'] 报错“Cannot use object of type stdClass as array”。
- 需要下标访问（如
$data['name']）或foreach遍历时保持键名，必须加true：json_decode($json, true) - 若 JSON 里有重复 key（如两个
"id"），对象模式会覆盖，数组模式同样覆盖——PHP 不支持重复键，这点和 JavaScript 不同 - 嵌套结构里混合使用对象/数组不现实，建议全程统一：要么全用
true，要么全用false并用->访问
cURL 返回的 JSON 带 BOM 或换行符导致解析失败
某些 API（尤其 Windows 后端或老旧 PHP 框架）返回的 JSON 响应头没设 Content-Type: application/json，且响应体开头带 UTF-8 BOM（\xEF\xBB\xBF）或意外换行，json_decode() 直接报 JSON_ERROR_SYNTAX。
立即学习“PHP免费学习笔记（深入）”；
- 用
hexdump -C或bin2hex(substr($json, 0, 4))检查前几个字节是否含 BOM - 安全去除 BOM：
$json = preg_replace('/^\xEF\xBB\xBF/', '', $json); - 更稳妥的做法是 trim + 验证：
$json = trim($json); if (!str_starts_with($json, '{') && !str_starts_with($json, '[')) { /* 非法 JSON 开头 */ }
大 JSON 字符串触发 recursion/nesting limit
PHP 默认限制 JSON 嵌套深度为 512 层（json.decode_depth），且递归层数受 xdebug.max_nesting_level 影响。解析超深结构（如大型树形菜单、日志嵌套对象）会返回 null，错误码是 JSON_ERROR_DEPTH 或 JSON_ERROR_RECURSION。
- 检查错误：
if (json_last_error() === JSON_ERROR_DEPTH) { /* 提示层级超限 */ } - 运行时调整（需权限）：
ini_set('json.decode_depth', 1024); - 生产环境不建议盲目调高，优先确认 JSON 是否真需要那么深——可能是数据建模问题
实际处理一个 API 响应时，最常漏掉的是三件事：没 trim 空白、没检查 json_last_error()、默认用了对象却当数组用。这些点卡住调试时间，比逻辑本身还耗神。
