如何创建无内存泄漏的JavaScript数据库实体对象？

直接用WeakMap按实体ID索引不可行——因为WeakMap的键必须是对象类型，不能是数字、字符串这类原始值，而你的实体ID显然是原始类型（比如数字42），所以没法直接用ID作为WeakMap的键来关联对应的Entity实例。

不过我们可以结合FinalizationRegistry和普通Map来实现需求：既保证同ID的Entity实例严格相等，又能在实例无其他引用时被垃圾回收，避免内存泄漏。具体实现如下：

// 维护ID到Entity实例的映射
const idToEntity = new Map();
// 注册回收回调，当Entity实例被GC时清理Map中的对应条目
const entityRegistry = new FinalizationRegistry((id) => {
  idToEntity.delete(id);
});

function createEntity({ id, ...rest }) {
  // 先查缓存，存在直接返回
  if (idToEntity.has(id)) {
    return idToEntity.get(id);
  }
  // 创建新实例
  const entity = { id, ...rest };
  // 存入缓存
  idToEntity.set(id, entity);
  // 注册回收监听：当entity被GC时，把对应的id传入回调删除缓存
  entityRegistry.register(entity, id);
  return entity;
}

工作原理 #

• 当首次创建某个ID的实体时，实例会被存入idToEntityMap，后续同ID请求直接复用该实例，保证createEntity({id:42}) === createEntity({id:42})。
• FinalizationRegistry会监听每个Entity实例，当实例不再被任何其他代码引用（即可以被垃圾回收时），会触发回调从idToEntity中删除对应的ID条目，这样Map不会持有实例的唯一引用，实例就能被正常回收，避免内存泄漏。

为什么不用WeakMap？ #

WeakMap的核心特性是：当键对象没有其他引用时，键值对会被自动回收，但它的键只能是对象。如果我们想按原始类型的ID来查找实例，WeakMap无法满足这个索引需求——总不能为每个ID创建一个专门的对象作为WeakMap的键，这反而会引入额外的复杂度和内存开销，不如用上面的方案直接。

内容的提问来源于stack exchange，提问作者David Braun