JavaScript Map.groupBy 怎样按对象引用分组

JavaScript Map.groupBy 按对象引用分组的关键，是让回调返回已经存在的同一个对象，再用这个原引用调用 get。属性相同的两个对象仍是两个键；在回调里每次创建对象，会把本想合并的记录拆开。下面用工单与负责人的原创场景，把输入、分组存储、查询、更新和清理串起来。代码用于解释语义，不代表本机运行记录。

标准文档：https://tc39.es/ecma262/multipage/keyed-collections.html#sec-map.groupby

先确定工单的负责人来自哪里

设想一块工单看板：负责人可以改显示名，但工单仍属于同一个负责人对象。如果应用状态层已经维护共享对象，按引用分组就很自然。反过来，若接口给每条记录分别嵌套一个负责人对象，即便它们的 id 相同，也不会自动合成同一组。先决定需要“同一个对象”还是“同一个业务 id”，比先选分组 API 更有用。

// 三条工单复用两个负责人对象；这决定了分组身份。
const lin = { id: "u-17", name: "林", active: true };
const zhou = { id: "u-28", name: "周", active: true };
const tickets = [
  { id: "T-11", owner: lin, status: "open" },
  { id: "T-12", owner: zhou, status: "open" },
  { id: "T-13", owner: lin, status: "pending" },
];

这里 T-11 和 T-13 的 owner 不只是内容相同，而是共同引用 lin。后面查询也要保留这个引用，不能用显示名重新组装一个对象代替它。

在入口约束共享对象与空值

Map.groupBy 接受可迭代对象和同步回调；它并不要求键必须是对象。null、undefined 或字符串也可以成为键。因此“缺少负责人就报错”属于应用规则，需要自己定义，不能期待 API 代劳。下面的入口函数只允许非空普通对象形态的负责人，排除数组；这不是通用对象类型验证器。

// 业务约束：每张工单都要有非空、非数组的负责人对象。
function ownerKey(ticket) {
  const owner = ticket?.owner;
  if (owner === null || typeof owner !== "object" || Array.isArray(owner)) {
    throw new TypeError("工单缺少有效负责人对象");
  }
  return owner; // 返回现有引用，不能在这里重新包装。
}

if (typeof Map.groupBy !== "function") {
  throw new Error("当前运行环境不支持 Map.groupBy");
}
let groups = Map.groupBy(tickets, ownerKey);

如果业务允许未分配工单，可以改为返回模块中预先创建的单一“未分配”对象，让这些记录共享一个键。不要把缺失字段误当成自动过滤条件：返回 undefined 只会建立 undefined 分组。

把对象引用保存为 Map 的键

结果 Map 中，每个不同的键对应一个新的数组；数组中的工单对象仍来自原输入，没有深拷贝。就这个输入而言，lin 对应 T-11、T-13，zhou 对应 T-12。组内顺序跟随输入迭代顺序，Map 的键顺序按首次出现排列；这不等于按姓名或工单编号排序。

如果负责人以 id 作为唯一身份，直接用 id 分组往往更清楚。只有其他逻辑确实依赖共享对象本身，才需要先通过 id 到对象的注册表统一引用；统一时还要处理同 id 属性冲突，不能静默覆盖数据。

用原引用查询并理解修改的边界

// 查询必须使用原引用；这里的注释描述该示例的语义结果。
const linTickets = groups.get(lin) ?? [];
const sameFields = { ...lin };
const absent = groups.get(sameFields); // undefined：属性相同也不是原键。

lin.name = "林工"; // 修改属性没有更换对象身份。
const stillFound = groups.get(lin) === linTickets; // true

tickets[0].status = "closed"; // 组内保存原工单对象，会看到状态变化。
tickets.push({ id: "T-14", owner: lin, status: "open" });
// 添加原数组元素不会自动扩充已生成的分组数组。
const rebuilt = Map.groupBy(tickets, ownerKey);

修改对象属性与维护分组成员是两件事。把某张工单的 owner 改成 zhou，旧 groups 中它仍留在原数组，但工单对象的新 owner 属性已经可见。这种“数组位置旧、对象字段新”的状态很容易误导看板。数据变动后重新分组，或者由业务代码显式移动成员；不要把一次计算得到的 Map 当作持续订阅。

处理新对象、异步回调和兼容性

回调写成 ticket => ({ id: ticket.owner.id }) 会为每条工单分配新的键，名字或 id 相同也不能合并。JSON 解析、对象展开或克隆产生的新对象同样不会恢复旧引用。若页面重新请求数据，重新创建分组，或改用稳定 id 作为键；不要依赖跨请求的对象身份。

还要避免 async 回调。Map.groupBy 不会等待回调返回的 Promise，而会把 Promise 对象本身作为键。若需异步获取负责人，先把数据准备好，再用同步回调分组。支持情况应以目标运行环境为准；类型声明存在或构建能通过，不意味着运行时已有该函数，入口的能力判断仍有必要。

回调抛异常会让本次调用失败，不会把半成品 Map 作为返回值交给你。把赋值放在调用成功之后，必要时保留旧索引，并向页面展示本次更新失败。它也不是无限流处理器：分组需要消费输入并保留成员，持续输入应另外设计窗口和清理策略。

归档为业务标识并清理索引

分组 Map 适合作为当前视图的内存索引。归档时应把负责人 id 与工单 id 显式写成数据，重新加载后再选择按 id 分组还是重建共享对象。引用身份无法靠一份 JSON 保留下来；也不要直接把对象键强行转成普通对象的属性名。

// 归档示例以当前 tickets 重建分组，避免保存陈旧成员关系。
groups = Map.groupBy(tickets, ownerKey);
const archiveRows = Array.from(groups, ([owner, items]) => ({
  ownerId: owner.id,
  ticketIds: items.map((ticket) => ticket.id),
}));

// 清空当前索引，不会清空 tickets，也不会修改已被其他代码保存的数组。
groups.clear();

Map 会持有键和组数组。clear 或 delete 去掉的是对应 Map 条目；原数组、局部变量和其他状态容器仍可能保留对象。清理视图时一起检查应用自身的引用生命周期，但不要把 clear 理解成强制垃圾回收。

同名负责人为什么还是两组？先看是不是两个独立对象。同名不是同引用，同 id 也需要应用自行决定合并规则。

改负责人姓名会丢失查询吗？原引用不变就不会因姓名变化而失效；但重新创建对象会改变身份。

分组后改了工单归属，为什么列表没移动？Map.groupBy 生成的是一次分组结果。重算或显式维护成员，才能同步数组归属。

技术依据：Map.groupBy 的键、回调与数组构造语义见 ECMAScript 规范；对象修改与原引用查询的解释见 MDN。参考地址：https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/groupBy