PHP没有内置函数能按多个字段联合去重，必须手动构造唯一标识（如serialize或json_encode联合字段）再过滤；array_unique对多维数组无效，仅支持一维标量。
直接说结论：PHP 没有内置函数能按多个字段联合去重，必须手动构造唯一标识，再用 array_unique() 或哈希表过滤。别指望 array_unique($array, SORT_REGULAR) 对多维数组生效——它会静默失败或返回原数组。
为什么 array_unique 不能直接处理多字段去重
array_unique() 只接受一维标量数组（字符串、数字等），传入关联子数组会触发警告并返回空或不完整结果。即使 PHP 5.2.9 声称“支持多维”，实际只是对简单索引二维数组做浅层比较，遇到键名不一致、嵌套或 null 值就崩。
常见错误现象：
- 去重后数组长度没变
- Warning: array_unique(): Array with keys is not supported（PHP 8+ 更严格）
- 重复项仍存在，但顺序乱了
本质是：PHP 不知道你关心哪几个字段组合算“重复”。必须你来定义这个逻辑。
用 serialize + array_unique 构造联合唯一键
这是最稳妥、兼容性最好的方案，适用于任意结构的多维数组，且不依赖字段顺序或键名一致性。
立即学习“PHP免费学习笔记（深入）”；
- 把每个子数组中你关心的字段提取出来，组成新数组（如
['name' => $v['name'], 'color' => $v['color']]） - 用
serialize()转成字符串，确保结构和值完全一致才被判定为重复 - 调用
array_unique()去重，再unserialize()还原
示例：
function uniqueByFields(array $array, array $fields): array
{
$serialized = [];
foreach ($array as $item) {
$keyData = [];
foreach ($fields as $field) {
$keyData[$field] = $item[$field] ?? null; // 处理缺失键
}
$serialized[] = serialize($keyData);
}
$uniqueSerialized = array_unique($serialized);
return array_map(function ($s) use ($array) {
// 找回原始子数组（保留首次出现的完整结构）
foreach ($array as $item) {
$keyData = [];
foreach ($fields as $field) {
$keyData[$field] = $item[$field] ?? null;
}
if (serialize($keyData) === $s) {
return $item;
}
}
}, $uniqueSerialized);
}
<p>// 使用：按 name 和 color 联合去重
$products = [
['id' => 1, 'name' => 'shirt', 'color' => 'red', 'size' => 'M'],
['id' => 2, 'name' => 'shirt', 'color' => 'red', 'size' => 'L'], // 与上条 name+color 相同 → 去掉
['id' => 3, 'name' => 'pants', 'color' => 'blue', 'size' => 'S'],
];
$result = uniqueByFields($products, ['name', 'color']);
用关联数组键做哈希去重（性能更好）
当数据量大（>10k 条）时，serialize() + array_unique() 的内存和时间开销明显上升。此时改用“键映射法”更高效：把联合字段拼成字符串作键，天然去重。
- 字段值需可安全拼接（推荐用
json_encode()或固定分隔符 +urlencode()） - 注意 null、布尔值、斜杠等特殊字符，避免键冲突
- 该方法不保留原始键名，只保证值唯一
示例（用 json_encode() 安全编码）：
$seen = [];
$unique = [];
foreach ($products as $item) {
$key = json_encode([$item['name'] ?? null, $item['color'] ?? null]);
if (!isset($seen[$key])) {
$seen[$key] = true;
$unique[] = $item;
}
}
容易被忽略的边界点
联合去重真正难的不是写代码，而是想清楚这几点：
- 字段值为
null、false、空字符串时是否视为相同？比如'color' => null和'color' => ''要不要合并？ - 大小写敏感吗？
'Red'和'red'是否算重复？需要提前strtolower() - 浮点数精度问题：
1.0和1在json_encode()中输出不同，但语义可能相同 - 如果要保留每组重复项中某个特定记录（如 id 最大的），就不能用上述任一方法，得先
usort()再分组取首/尾
这些细节不处理，上线后数据就 quietly 错了。
