空数组变null主因是类型异常或误用json_force_object;加该flag会强制空数组变为{};报错“type not supported”实为数组含资源等非法值;老版本应加固输入确保is_array。

PHP JSON encode 空数组变 null 怎么办
PHP 的 json_encode() 默认把空数组 [] 编码成 JSON 数组 [],但如果你发现它变成了 null,大概率是这个数组被当成“不可序列化对象”处理了——比如它其实是 ArrayObject 实例、或被 unset() 后残留的“伪空数组”,又或者你误用了 JSON_FORCE_OBJECT。
实操建议:
- 先用
var_dump($arr)确认类型和结构,重点看是不是array(0) { }还是object(ArrayObject)#123 - 避免对变量做隐式类型转换,比如
$arr = (array)$obj后再json_encode(),某些场景下会丢失键名或触发异常行为 - 如果确定是普通空数组却仍输出
null,检查是否启用了JSON_PARTIAL_OUTPUT_ON_ERROR且前面有其他编码失败项干扰了状态
为什么加 JSON_FORCE_OBJECT 后空数组变空对象 {}
这是 JSON_FORCE_OBJECT 的明确行为:它强制所有数组(包括索引数组)按对象方式序列化。空索引数组 [] 就变成 {},而非 []。这不是 bug,是设计使然——PHP 认为“索引数组 + 强制对象”应映射为 JSON object。
常见错误现象:
立即学习“PHP免费学习笔记(深入)”;
- 前端 expect
[]却收到{},导致Array.isArray(res.data)返回 false - 后端 API 文档写明返回 “array of string”,实际响应却是 object,引发校验失败
使用场景判断:
- 只在需要统一返回 object 结构(如所有字段都用 key-value 形式)时才启用该 flag
- 若接口契约要求某字段必须是数组(哪怕为空),就绝不能加
JSON_FORCE_OBJECT
空数组被 json_encode 报错 “type is not supported”
这种错误通常不是空数组本身的问题,而是数组里混入了无法 JSON 序列化的值,比如 resource、closure、未实现 JsonSerializable 的自定义对象,或循环引用对象。
排查步骤:
- 用
array_walk_recursive($arr, function($v) { var_dump(gettype($v)); })扫描所有叶子节点类型 - 检查是否有
mysqli_result、curl handle、__set_state生成的临时对象等“隐形资源” - 对可疑变量提前过滤:
array_filter($arr, function($v) { return is_scalar($v) || is_null($v); })
注意:空数组本身永远不会触发这个错误,报错一定是内部藏了“非法值”。
兼容老版本 PHP(如 5.6)时怎么安全输出空数组
PHP 5.6+ 对空数组支持稳定,但部分老旧环境(尤其是打了非官方补丁的定制版)可能在处理 json_encode([]) 时因扩展版本不一致出问题。此时最稳妥的做法不是改逻辑,而是加固输入。
实操建议:
- 始终在
json_encode()前做类型断言:if (!is_array($data)) { $data = []; } - 避免直接传变量引用,改用副本:
json_encode(array_values($arr))可剥离关联键带来的潜在歧义 - 加错误抑制符不是好办法,但紧急兜底可用:
@json_encode($arr) ?: '[]'(仅限明确知道 $arr 是合法数组时)
真正容易被忽略的是:很多框架(如 Laravel 的 response()->json())底层会自动调用 json_encode(),你以为没动它,其实中间件或服务提供者已悄悄加了 flags。











