WeakValueDictionary 可实现自动清理的离线数据缓存池，其值为弱引用，对象无强引用时自动回收；需配合空值检查、终结器清理资源，并用锁保障多线程安全。
用 WeakValueDictionary 就能直接实现——它天然支持“值被回收，条目自动消失”，不需要手动清理或计数。
核心结构：用 WeakValueDictionary 承载数据主体
离线数据字典池的关键是：数据对象（比如解析后的 JSON 记录、图像元数据、缓存的模型实例）应能被自由释放，而字典本身不干预其生命周期。
- 选
weakref.WeakValueDictionary，不是普通dict，因为它的 value 是弱引用；只要数据对象在其他地方没了强引用，GC 一触发，它就被回收，对应键值对也立刻从字典中消失 - key 可以是字符串 ID、整数索引或不可变元组——必须可哈希，且生命周期不受字典控制（WeakValueDictionary 不弱化 key）
- 避免把 list、dict 等内置可变类型直接当 value 存——它们默认不可弱引用；可包装成自定义类实例，或确保你存的是用户定义类的对象（如
DataRecord）
配合 ref + 回调，做轻量级生命周期感知
有些场景需要在数据被回收前执行清理动作，比如关闭临时文件句柄、注销信号监听、记录日志等。
- 对每个插入的数据对象，调用
weakref.finalize(obj, cleanup_func, *args)注册终结器 - 终结器会在对象被 GC 前精确触发一次，适合资源解绑，比轮询或定时清理更可靠
- 注意：finalize 不影响对象是否被回收，只提供钩子；多个 finalize 可共存，互不干扰
防止意外强持有：访问时加空值检查
WeakValueDictionary 的 value 可能在任意时刻变成 None（比如 GC 刚运行完），所以读取不能直接用 pool[key]，否则会抛 KeyError 或得到已失效对象。
- 推荐写法：
obj = pool.get(key)，然后显式判断if obj is not None: - 如果需要“有就返回，没有就重建并缓存”，可封装成原子方法：
obj = self.pool.get(key)
if obj is not None:
return obj
obj = self._load_data(key) # 实际加载逻辑
self.pool[key] = obj
return obj
扩展健壮性：加一层线程安全与容量提示
大容量池常用于多线程环境，但 WeakValueDictionary 本身不保证线程安全。
- 用
threading.RLock包裹关键操作（get / set / pop），避免并发修改引发状态不一致 - 不建议硬限制 size——弱引用池的“大小”本就是动态浮动的；但可以定期用
len(pool)监控活跃项数量，超阈值时主动del一些低频 key（注意：del key 只删映射，不强制回收 value） - 若需按访问时间淘汰，可额外维护一个
OrderedDict记录 key 的使用顺序，与 WeakValueDictionary 配合使用（WeakValueDictionary 负责回收，OrderedDict 负责排序）
