本文介绍在 php 中如何以 uuid 字段为键，安全、准确地合并两个结构相同的数组，生成按 uuid 分组的嵌套结果，避免 array_combine 导致的类型转换错误。
本文介绍在 php 中如何以 uuid 字段为键，安全、准确地合并两个结构相同的数组，生成按 uuid 分组的嵌套结果，避免 array_combine 导致的类型转换错误。
在实际开发中，常需将多个来源（如不同 API 响应或数据库查询）的数组按唯一标识符（如 UUID）进行对齐合并。原始代码试图用 array_combine($new_arr1, $new_arr2) 合并两个以 UUID 为键的关联数组，但该函数要求两个参数均为一维索引数组，而 $new_arr1 和 $new_arr2 实际是二维关联数组（键为 UUID，值为子数组），导致 PHP 尝试将数组强制转为字符串，从而抛出 “Array to string conversion” 警告。
正确做法是：先统一构建以 UUID 为键的目标结构，再逐数组填充字段，而非分步构造再强行组合。以下是推荐的清晰、健壮实现：
<?php
$arr1 = [
['UUID' => '123a-123a', 'name' => 'A1'],
['UUID' => '123b-123b', 'name' => 'B1'],
['UUID' => '123c-123c', 'name' => 'C1']
];
$arr2 = [
['UUID' => '123a-123a', 'name' => 'A2'],
['UUID' => '123b-123b', 'name' => 'B2'],
['UUID' => '123c-123c', 'name' => 'C2']
];
// 初始化结果数组，以 UUID 为键
$result = [];
// 合并 arr1：映射为 name_1
foreach ($arr1 as $item) {
$uuid = $item['UUID'];
$result[$uuid]['name_1'] = $item['name'];
}
// 合并 arr2：映射为 name_2
foreach ($arr2 as $item) {
$uuid = $item['UUID'];
$result[$uuid]['name_2'] = $item['name'];
}
print_r($result);✅ 输出完全符合预期：
Array
(
[123a-123a] => Array
(
[name_1] => A1
[name_2] => A2
)
[123b-123b] => Array
(
[name_1] => B1
[name_2] => B2
)
[123c-123c] => Array
(
[name_1] => C1
[name_2] => C2
)
)⚠️ 注意事项：
- 不要使用 array_combine() 处理多维数组——它仅适用于数值索引的一维数组配对；
- array_merge_recursive() 虽可递归合并，但不适用于本场景：它会将同键值自动合并为数组（如 name_1 可能变成 [A1, ...]），且无法控制字段别名（如 name_1/name_2）；
- 建议增加 UUID 存在性校验（如 isset($item['UUID'])）以提升鲁棒性；
- 若数据量大，可封装为函数并支持任意数量数组及自定义字段映射规则。
此方案逻辑直观、易于维护，是 PHP 中基于唯一键合并数组的最佳实践之一。
