PHP解析JSON出错需同步排查错误码、输入清洗和上下文环境；必须立即调用json_last_error()和json_last_error_msg()，预清除BOM与控制字符，推荐启用JSON_THROW_ON_ERROR并配合try-catch捕获JsonException。
PHP解析JSON数组出错时，不能只看返回值是否为null，必须结合错误码、输入清洗、上下文环境三方面同步排查。静默失败是常态，主动捕获才是关键。
立即检查json_last_error()与json_last_error_msg()
json_decode()默认不报错，失败只返回null，而错误状态保存在全局函数中，稍有干扰就会被覆盖。
- 调用json_decode()后必须立刻执行json_last_error()，不能中间插入任何其他JSON操作（如日志里调用json_encode）
- 用json_last_error_msg()获取可读提示，比如“Syntax error”“Unexpected control character”“Malformed UTF-8 characters”
- 常见错误码：JSON_ERROR_SYNTAX（格式错）、JSON_ERROR_UTF8（编码非法）、JSON_ERROR_DEPTH（嵌套超512层）
预清洗输入再解析，避开BOM和控制字符
前端或API返回的JSON常带隐藏陷阱：UTF-8 BOM头、零宽空格、行分隔符（U+2028/U+2029）、C语言风格控制符（\x00–\x08等），这些都会导致解析直接失败。
- 先用ltrim($json, "\xEF\xBB\xBF")移除BOM
- 再用preg_replace('/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/', '', $json)剔除非法控制字符
- 最后trim()去首尾空白——这三步建议封装成统一清洗函数，所有外部输入都过一遍
启用JSON_THROW_ON_ERROR，让错误显性化
PHP 7.3+支持该标志，使json_decode()在失败时抛出JsonException，比手动查错误码更直观，尤其适合API入口或核心数据处理层。
立即学习“PHP免费学习笔记（深入）”；
- 写法示例：json_decode($json, true, 512, JSON_THROW_ON_ERROR)
- 必须配合try-catch使用，捕获JsonException类型（注意：它不是Exception的子类，在PHP 7.3–8.0中是独立异常）
- 该选项不影响json_encode()，仅作用于json_decode()
验证输入合法性，避免无效字符串进入解析流程
对不可信来源（如$_POST、file_get_contents、curl响应）的数据，应在解析前做轻量级结构校验，减少无效调用。
- 用正则粗筛结构：
filter_var($json, FILTER_VALIDATE_REGEXP, ['options' => ['regexp' => '/^\s*(?:\{.*\}|\[.*\])\s*$/']]) - 或直接尝试极浅解析：
json_decode($json, null, 1, JSON_THROW_ON_ERROR)，深度设为1可快速暴露语法问题且不耗资源 - 检查响应内容类型：若远程API返回的是HTML（如404页面）或XML，json_decode必然失败，需先判断header或响应体特征
