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。
