应先调用json_last_error()确认解析是否成功,若为json_error_none再判断解码后内容;对空对象{}或空数组[],可用json_encode($data) === '{}' || json_encode($data) === '[]'安全判断。

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(对应 JSONnull),类型必须检查 - 常见误判:
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 格式写错了。
立即学习“PHP免费学习笔记(深入)”;
- 接收外部输入(如 POST body、文件读取)前,先做清理:
$json = trim($json); - 去掉 BOM:
$json = preg_replace('/^\xEF\xBB\xBF/', '', $json); - 调试时加一行:
var_dump(bin2hex(substr($json, 0, 3))); // 看前三个字节是不是 BOM
json_decode() 后立刻检查 json_last_error()。一旦解析失败,后续所有判断都建立在 null 上,逻辑就全偏了。











