PHP判断JSON是否为空的实用技巧

本文深入剖析了PHP中判断JSON是否为空的常见误区与正确实践，强调必须先通过json_last_error()确认解析成功（返回JSON_ERROR_NONE），再依据业务需求精准判断“逻辑空”——如空对象{}、空数组[]或纯空白字符串；明确指出仅依赖json_decode()返回值是否为null或滥用empty()极易误判，尤其在处理"0"、false、null等合法JSON值时；同时提醒开发者警惕BOM字符和空白符导致的语法错误，并推荐统一使用json_decode($json, true)返回数组以简化判断，提供安全、健壮且可维护的JSON空值检测方案。

json_decode() 返回 null 怎么判断是不是真为空

PHP 里 json_decode() 遇到非法 JSON 或空字符串，统一返回 null，但这不等于“JSON 内容为空”。比如 ""、"null"、"{}"、"[]" 都会得到不同结果，不能只靠 === null 下结论。

• 先用 json_last_error() 确认是否解析失败：如果返回 JSON_ERROR_NONE，说明 JSON 合法，再看内容
• json_decode($str, true) 的返回值可能是 array、string、int、null（对应 JSON null），类型必须检查
• 常见误判：empty(json_decode($str)) —— 对 0、"0"、false 也返回 true，完全不可靠

怎么安全判断一个 JSON 字符串是否“逻辑上为空”

所谓“逻辑上为空”，通常指：空对象 {}、空数组 []、或根本没内容（空字符串/空白）。但业务含义不同，得按需区分。

• 若只要求“非空 JSON 结构”：trim($json) !== '' && json_last_error() === JSON_ERROR_NONE
• 若要求解码后是“空数组或空对象”：is_array($data) && count($data) === 0（注意：关联数组和索引数组都适用）
• 若要兼容 null、false、0 等 JSON 原生值，又不想误杀，就别用 empty()，改用 json_encode($data) === '{}' || json_encode($data) === '[]'

json_decode() 第二个参数设为 false 时的坑

默认或设为 false 时，json_decode() 返回 stdClass 对象，这时候 count() 会报 Warning，empty() 行为也不直观。

• count((array)$obj) 可临时转数组，但嵌套对象会丢失结构，慎用
• 更稳妥的是统一用 json_decode($json, true)，强制返回数组——除非你明确需要对象属性访问语法
• 判断对象是否“空”：可用 get_object_vars($obj) === []，但前提是已确认不是 null 且解析成功

空白字符和 BOM 导致 json_last_error() 返回 JSON_ERROR_SYNTAX

肉眼看着是空或只有一对花括号，但开头有 UTF-8 BOM（\xEF\xBB\xBF）或不可见空格，json_decode() 就直接失败，json_last_error() 返回 JSON_ERROR_SYNTAX，容易误以为 JSON 格式写错了。

• 接收外部输入（如 POST body、文件读取）前，先做清理：$json = trim($json);
• 去掉 BOM：$json = preg_replace('/^\xEF\xBB\xBF/', '', $json);
• 调试时加一行：var_dump(bin2hex(substr($json, 0, 3))); // 看前三个字节是不是 BOM

今天关于《PHP判断JSON是否为空的实用技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！