PHP array_filter 后 JSON 为什么变成对象

PHP 接口里最容易让人困惑的一种变化是：原来输出的是 JSON 数组，经过 array_filter 后却变成了 JSON 对象。通常不是 json_encode 随机改变类型，而是过滤结果仍然保留原数字键，例如 0、2、4。数字键不再从 0 连续递增时，PHP 会按键值显式编码，前端看到的就是对象。

如果过滤结果代表“列表”，在编码前使用 array_values($filtered) 重建连续索引；如果这些键本来就是业务 ID，则应保留对象形状，不要为了外观强行重排。

观察 array_filter 保留键后的 JSON 形状

array_filter 的返回值仍是 PHP 数组，但官方手册明确说明它会保留原键。过滤掉下标为 1 和 3 的元素后，数组实际变成 0、2、4。PHP 数组本质上是有序映射，不能只看它打印出来像不像列表。

 'A100', 'price' => 19],
    ['sku' => 'B200', 'price' => 0],
    ['sku' => 'C300', 'price' => 29],
];

$filtered = array_filter($items, function (array $item): bool {
    // 只保留可售价格，回调返回 true 才会留下元素
    return $item['price'] > 0;
});

echo json_encode(['items' => $filtered], JSON_UNESCAPED_UNICODE), PHP_EOL;
// items 的键是 0、2，结果会是对象而不是 JSON 数组
?>

这段代码的关键不在回调条件，而在结果键。若响应类似 {"items":{"0":...,"2":...}}，先检查过滤前后的键，比盯着前端类型报错更快。

用 array_values 重建连续列表

当 items 的业务含义是“按顺序排列的商品列表”，解决方式是明确重建索引，而不是给 JSON 再套一层转换。array_values 会丢弃原键，按遍历顺序生成从 0 开始的连续键。

 0;
});
$response = [
    // array_values 让 items 回到 0、1、2 的连续键
    'items' => array_values($filtered),
];

try {
    // 失败时抛出异常，避免把 false 当成正常响应发送
    echo json_encode($response, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
} catch (JsonException $exception) {
    // 记录异常后交给统一错误处理中间件
    error_log($exception->getMessage());
    http_response_code(500);
}
?>

如果数据还会嵌套一层，例如 ['data' => ['items' => $filtered]]，只对真正代表列表的 items 调用 array_values。不要对整个响应数组调用，否则会把 data、meta 这样的字段名一起丢掉。

区分列表、关联数组和强制对象

不是所有 JSON 对象都是问题。下面的判断可以作为接口设计时的速查表：

JSON_FORCE_OBJECT 解决的是“强制对象”需求，不是“过滤后列表变对象”的修复。若前端期待数组，给它一个稳定的数组契约更可靠；若前端需要按业务 ID 查找，保留键反而能避免丢失标识。

检查嵌套数组、空结果和错误处理

空结果是另一个容易被忽略的边界。array_values([]) 编码为 []，这通常比把“没有数据”写成 {} 更符合列表字段的预期。相反，明确表示键值映射的空结构可以用空对象表达，但应在接口文档中固定下来。

发布接口前至少检查三种输入：保留全部元素、过滤掉中间元素、全部过滤。分别确认 items 的 JSON 类型没有因为数量变化而改变。PHP 7.3 及以上可以使用 JSON_THROW_ON_ERROR 把编码失败转成异常；它处理的是非法 UTF-8、递归深度等编码错误，与数组是否为列表是两件事。

相关问题

array_filter 会自动重排数组下标吗？

不会。它保留通过筛选元素的原键，需要列表时显式调用 array_values。

为什么 PHP 数字键不连续就变成 JSON 对象？

JSON 数组没有可见键名，PHP 只有在键从 0 连续递增时才能安全表达列表；否则会把键和值一起写出。

能不能一直使用 JSON_FORCE_OBJECT？

不能把它当修复手段。它会把本来应是 JSON 数组的结构也强制成对象，只有接口契约明确要求对象时才使用。