collection::unique() 默认不保留原始键名，因其底层调用 array_values() 导致键重置；按字段去重时亦无法保证保留指定键，需手动结合 mapwithkeys、array_unique 和 only 等方法控制逻辑。
Collection::unique() 默认不保留原始键名
ThinkPHP 的 Collection 类中 unique() 方法默认返回的是重新索引的数值数组，原始键名（尤其是关联键如 'user_id'、'order_123'）会被丢弃。这不是 bug，是底层调用 array_values() 导致的——它只关心值唯一性，不维护键映射关系。
常见错误现象：
• 原数组 ['a' => 'x', 'b' => 'y', 'c' => 'x'] 经 $collection->unique() 后变成 [0 => 'x', 1 => 'y']，丢失了 'a' 和 'c' 的语义；
• 后续用 foreach ($col as $key => $val) 时，$key 不再对应业务 ID 或来源标识。
解决办法只有手动重建键映射，不能依赖 unique() 自带行为：
- 先用
unique()获取去重后的值列表 - 再用原始数据遍历，用
in_array($val, $uniqueValues, true)找出首次匹配项的原始键 - 或直接改用
filter()+collect()+array_unique()组合控制流程
按字段去重时 unique('field') 会破坏原始键结构
Collection::unique('status') 看似方便，但它内部执行的是「提取该字段值 → 去重 → 回填原数组对应项」，这个过程会打乱原始键顺序，且只保留第一次命中该字段值的整行数据——但该行的键名未必是你想要的。
例如原始集合键为 [101 => [...], 102 => [...], 103 => [...]]，其中 status 都是 'pending'，那么 unique('status') 只留 101 对应项，102 和 103 被丢弃，但你无法控制是否必须留 101 —— 它取决于遍历顺序，而 Collection 遍历顺序不保证稳定（尤其经过 sortBy() 后）。
若需严格按某个规则选“保留哪一条”，必须显式排序后再去重：
- 先
sortByDesc('created_at')确保最新记录在前 - 再
unique('user_id')，这样每个user_id保留的就是最新那条 - 注意：此组合仅在单次链式调用中有效；拆成两步后，
unique()作用于已排序的新集合，键名仍是重排过的
想真正保留原始键名？别用 unique()，改用 collect() + array_unique() 手动处理
当业务强依赖键名（比如前端传来的 items 数组以 UUID 为键，后端需按原键返回校验结果），Collection::unique() 就不合适。必须绕过它，用 PHP 原生函数控制逻辑。
核心思路：把键和值一起打包，去重时比对值，但保留键：
- 用
mapWithKeys()把原始集合转成[$key => ['value' => $item['code'], 'original_key' => $key]] - 抽取出
code列表，用array_unique($codes, SORT_REGULAR)去重（注意加SORT_REGULAR，否则null/0/false误判） - 再遍历原始集合，用
! in_array($item['code'], $uniqueCodes, true)标记重复项，跳过即可 - 最终用
filter()+keys()拿到要保留的原始键，再only()提取
示例关键片段：
$codes = $collection->pluck('code')->all();
$uniqueCodes = array_unique($codes, SORT_REGULAR);
$keepKeys = [];
foreach ($collection as $key => $item) {
if (in_array($item['code'], $uniqueCodes, true) && !isset($keepKeys[$item['code']])) {
$keepKeys[$item['code']] = $key;
}
}
$result = $collection->only(array_values($keepKeys));
Collection::unique() 和数据库 distinct() 的行为根本不同
有人试图用 Collection::unique() 模拟 SQL 的 DISTINCT，这是危险的类比。distinct() 是数据库层按字段组合去重，返回的是完整行；而 Collection::unique() 是内存层按单字段或全值去重，且不保证字段一致性（比如两个对象只有 name 相同，其他字段不同，unique('name') 只留第一个，其余字段信息被截断）。
更隐蔽的问题是类型松散比较：
• 数据库 DISTINCT 严格区分 '1' 和 1（字符串 vs 整数）
• Collection::unique('id') 默认用 PHP 松散比较，'1' 和 1 被视为相同，导致意外丢数据
所以：小量、简单结构、类型可控时可临时用 unique()；只要涉及混合类型、嵌套字段、或需要审计原始键来源，就必须回归手动控制逻辑，别图省事。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
