array_merge_recursive 的本质是同名键值“收集”而非覆盖，遇字符串键则合并为数组，数字键追加，嵌套仅同为数组时递归；误用于配置合并易致混合结构崩溃。
array_merge_recursive 会把相同键名的值自动合并成数组，不是覆盖
这是它和 array_merge 最本质的区别：遇到重复键，array_merge_recursive 不丢数据，而是把值“塞进一个新数组里”。比如两个数组都有 'name' 键，结果里 'name' 就会变成一个包含两个值的数组。
常见错误是以为它能“深层覆盖”——比如用第二个数组的 'user.id' 替换第一个里的，但它根本不会解析点号或嵌套路径，只看顶层键名。它也不是深拷贝工具，只是递归地对同名键做“收集”动作。
- 如果键是数字索引（如
0、1），行为和array_merge一样：直接追加，不合并 - 如果键是字符串（如
'config'），且两个数组都有，就会把对应值各自放进一个数组，哪怕值是null或array() - 嵌套数组会被递归处理，但仅限于「同名键 + 都是数组」的情况；如果一边是数组、另一边是字符串，结果里那个键就变成
[字符串, 数组]这种混合结构
合并配置时容易把 string 和 array 混在一起导致逻辑崩溃
典型场景是合并默认配置和用户配置：$defaults 里 'database' => ['host' => 'localhost']，用户传了 'database' => 'sqlite://db.sqlite'。这时 array_merge_recursive 产出的 'database' 是 ['sqlite://db.sqlite', ['host' => 'localhost']] —— 一个混合数组，后续代码按数组遍历或按字符串调用都会出错。
这不是函数 bug，而是误用了它的语义。它设计目标是“聚合同类数据”，不是“安全覆盖配置”。
立即学习“PHP免费学习笔记（深入）”；
- 检查输入值类型是否一致：合并前用
is_array()判断两边是否都为数组，否则手动决定用哪个 - 对关键配置项（如
'driver'、'timeout'）单独提取，不参与递归合并 - 更稳妥的做法是用
array_replace_recursive（PHP 5.3+），它在遇到非数组值时会直接替换，而不是拼成数组
空数组或 null 值参与合并会留下脏数据
array_merge_recursive([], ['a' => null]) 结果是 ['a' => [null]]；array_merge_recursive(['x' => []], ['x' => ['y' => 1]]) 得到 ['x' => [[], ['y' => 1]]] —— 注意，第一个 [] 是空数组，它不会被忽略，也不会被“展开”，就老老实实待在合并后的数组里。
这种结构在后续用 foreach 遍历时可能触发 Invalid argument supplied for foreach()，因为你在遍历一个包含空数组的数组。
- 合并前用
array_filter($arr, function($v) { return $v !== null && $v !== []; })清洗掉无意义值（注意：这会删掉0、false、''，按需调整判断条件） - 如果必须保留
0或false，改用严格判断：$v === null || $v === [] - 避免把未初始化的变量（如
$config['cache']未定义）直接扔进去，先isset()或给默认空数组
性能差在深度嵌套 + 大量同名键时特别明显
它内部是递归实现，每层都要做键存在性检查、类型判断、数组创建。当嵌套 5 层以上、每层有几十个同名键时，比简单 array_replace_recursive 慢 3–5 倍，且内存占用翻倍——因为所有同名值都被包进新数组，哪怕只有一个值。
如果你只是想“让后一个数组的值优先生效”，它就是杀鸡用牛刀。
- 确认真实需求：是要“收集所有同名字段”（如日志标签、多语言翻译条目），还是“以右边为准覆盖”？前者才用它
- 大数组合并前考虑分块，或改用迭代写法（自己写个栈模拟递归，控制中间数组创建）
- PHP 7.4+ 可用 splat operator：
[...$a, ...$b]合并顶层，再对特定键手工递归，更可控
