array_reduce嵌套降维出错的根本原因是内层回调未显式return或初始值非数组,导致外层传入null;正确写法只需一层array_reduce配合array_merge及空数组初始值。

array_reduce 嵌套降维时为什么结果是 null 或报 Warning?
直接嵌套 array_reduce 降维二维数组,最常见问题是内层回调没返回值(或返回了非数组),导致外层 array_reduce 下一次迭代时传入 null,触发 Warning: array_merge(): Argument #2 is not an array。
根本原因:PHP 的 array_reduce 要求每次回调**必须显式 return**,且初始值(第二个参数)类型需与回调返回值一致。若漏写 return,或在某些分支里没 return,就会中断链式累积。
- 初始值必须是数组(如
[]),不能省略或写成null - 内层
array_reduce的回调也必须以return array_merge($carry, $item)结尾,不能只写array_merge(...) - 如果子数组可能为非数组(比如含字符串或 null),得先用
is_array($item)过滤
用 array_reduce + array_merge 降维的最小可靠写法
这是能稳定跑通的最简模式,适用于纯二维、元素全为数组的场景:
$arr2d = [[1, 2], [3, 4], [5]];
$result = array_reduce($arr2d, function ($carry, $item) {
return array_merge($carry, $item);
}, []); // 注意:初始值必须是 []
// $result === [1, 2, 3, 4, 5]
关键点不是“嵌套”,而是**单层 array_reduce 配合 array_merge 就够了**——二维降一维不需要两层 array_reduce。所谓“嵌套”往往是误读,实际只需一层累积合并。
立即学习“PHP免费学习笔记(深入)”;
- 不要写
array_reduce($item, ...)套在内层:那是为处理三维及以上准备的 -
array_merge比$carry + $item更安全,后者会忽略数字键重复问题 - 性能上,
array_merge在 PHP 7.4+ 对连续数字索引做了优化,比循环foreach+[]追加略快
遇到非标准二维结构(含空值、字符串、null)怎么办?
真实数据常混杂非数组项,比如 API 返回的 [["a","b"], null, ["c"]],这时直接 array_merge 会报错。必须加守卫逻辑:
$result = array_reduce($arr2d, function ($carry, $item) {
if (is_array($item)) {
return array_merge($carry, $item);
}
return $carry; // 忽略非数组项
}, []);
更保守的做法是先用 array_filter($arr2d, 'is_array') 预处理,再进 array_reduce。但注意:array_filter 默认会重排键,如果依赖原始顺序(比如按 index 对应记录),就得加 ARRAY_FILTER_USE_KEY 并手动处理。
- 别用
empty($item)判断,它对[0]或[""]也会误判为 false - 如果要保留非数组项作为标量(如把
"hello"变成["hello"]),可改为array_merge($carry, (array)$item) -
(array)$item是兜底技巧,能把字符串、数字、null 都转成长度为 1 的数组
array_reduce 降维和 foreach 循环比,有什么隐藏代价?
代码看似函数式更“优雅”,但实际有两点容易被忽略:
- 每次
array_merge都生成新数组,内存占用是 O(n²) 级别——合并 k 个子数组,第 i 次操作拷贝约 i×avg_len 个元素 - PHP 8.0+ 引入了
array_flat_map(仍在 RFC 阶段),目前没有原生高效替代;若数据量大(>10k 元素),foreach+array_push(...$item)或预分配array_values(array_merge(...))反而更稳 -
array_reduce的回调无法用yield,没法做惰性求值,不适合流式处理
真正该警惕的不是语法怎么写,而是是否在小数据上过度设计——很多所谓“技巧”只是把简单事绕远了。二维降一维,foreach 明确、易 debug、无隐式行为,往往就是最优解。











