weakmap 不适合缓存 di 容器的全局单例服务，因其键为弱引用，实例无强引用时会被 gc 回收，违背单例“长期存活”语义；它适用于按实例绑定的上下文隔离缓存，如作用域服务、插件状态或请求级依赖，通过以 scope 对象为键自动清理缓存，配合生命周期而非替代生命周期策略。
为什么 WeakMap 不适合做全局单例缓存
DI 容器的单例（singleton）模式要求服务实例长期存活、全局可复用。WeakMap 的键是弱引用，一旦没有其他强引用指向该服务实例，它就会被 GC 回收，对应缓存条目也消失——这与单例“始终存在”的语义冲突。所以单例应使用 Map 或普通对象缓存，WeakMap 在这里会适得其反。
WeakMap 的合理角色：绑定服务实例与其私有上下文
它更适合在以下场景中辅助生命周期管理：
- 插件式服务封装：每个插件实例（如一个图表渲染器、表单验证器）作为 WeakMap 的键，存入其专属配置、缓存数据或内部状态对象；插件卸载后，状态随实例自动释放
- 请求/组件作用域缓存：在 SSR 或微前端中，将当前请求对象（Request）或组件实例（如 React 组件 this）作键，缓存本次作用域内已解析的依赖；请求结束或组件 unmount 后，无需手动清理
- 避免闭包强引用泄漏：当服务工厂函数需访问外部上下文（如用户 session），不把 context 直接闭包捕获进 handler，而是通过 WeakMap 关联到 request 实例，防止 handler 长期持有时拖住整个上下文
实际写法示例：带作用域的 DI 辅助缓存
假设你有一个轻量 DI 容器，支持按 scope 创建服务：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
const scopeCache = new WeakMap(); // 键：scope 对象（如 req / component），值：该 scope 下的服务实例 Map
class ScopedContainer {
resolve(key, scope) {
if (!scopeCache.has(scope)) {
scopeCache.set(scope, new Map());
}
const scopeMap = scopeCache.get(scope);
if (!scopeMap.has(key)) {
const instance = this._createInstance(key);
scopeMap.set(key, instance);
}
return scopeMap.get(key);
}
}
这里 WeakMap 不缓存服务本身，而是缓存“每个作用域专属的 Map”。scope 对象（比如 Express 的 req）销毁后，整个 scopeMap 自动可回收，里面的服务实例若无其他引用，也会一并释放。
必须避开的陷阱
使用 WeakMap 辅助 DI 时，容易踩的坑包括：
- 把服务类构造函数或字符串 token 当作键（WeakMap 只接受对象，否则报错）
- 在值中保存对键的强引用（如
{ owner: scope }），造成循环引用，阻碍 GC - 误以为 WeakMap 能“管理”服务生命周期——它只配合生命周期，不能替代生命周期策略本身
- 未校验 scope 是否为有效对象，传入 null 或原始值导致 set 失败却无提示
WeakMap 在 DI 中的价值，是让缓存行为与对象生命周期自然对齐，不是替代容器的生命周期设计。真正决定“何时创建、何时复用、何时销毁”的，仍是注册时声明的 scope 策略（singleton / transient / scoped），WeakMap 只是让 scoped 缓存更安全、更轻量。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
