空数组变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。
