本文共计676个文字，预计阅读时间需要3分钟。

使用 `weakref` 实现自动失效的本地 Session 管理器，核心思路是：

为什么不用普通字典？

普通 dict 作为 Session 容器时，会强持有每个 Session 对象，导致：

• 用户关闭页面、退出登录后，Session 对象仍驻留内存
• 长期运行的服务中 Session 数量持续增长，引发内存泄漏
• 无法与对象实际生命周期对齐（比如某个用户 Session 就是某个 User 实例）

推荐方案：WeakValueDictionary + 唯一键映射

使用 weakref.WeakValueDictionary 作为底层存储，值是弱引用；再配合一个轻量键生成策略（如用户 ID 或 token 字符串），即可实现“自动失效”：

• Session 对象（如 UserSession 实例）由业务逻辑创建并持有
• 管理器只以该对象为值存入 WeakValueDictionary，不额外强引用它
• 当业务逻辑中所有变量都释放了对该 Session 的引用，GC 触发后，它会从字典中自动消失

关键实现细节

注意以下三点，避免踩坑：

• Session 类必须支持弱引用：默认类实例支持；若用了 __slots__，需显式包含 __weakref__
• 键不能是 Session 对象本身：WeakKeyDictionary 要求键可弱引用，但通常 Session 键是字符串（如 "sess_abc123"），更适合用 WeakValueDictionary
• 访问时需判空：调用 cache[key] 可能返回 None（对象已被回收），应做安全解包

一个最小可行示例

以下是一个线程安全、自动失效的 Session 管理器骨架：

import weakref import threading <p>class SessionManager: def <strong>init</strong>(self): self._cache = weakref.WeakValueDictionary() self._lock = threading.RLock()</p><pre class="brush:php;toolbar:false;">def set(self, key: str, session_obj): with self._lock: self._cache[key] = session_obj # 值为弱引用 def get(self, key: str): with self._lock: sess = self._cache.get(key) return sess if sess is not None else None def delete(self, key: str): with self._lock: self._cache.pop(key, None)

使用示例

class UserSession: def init(self, user_id): self.user_id = user_id self.created_at = time.time()

mgr = SessionManager() s1 = UserSession("u1001") mgr.set("sess_u1001", s1)

print(mgr.get("sess_u1001")) # del s1 print(mgr.get("sess_u1001")) # None（下次 GC 后即失效）

不需要定时扫描、不依赖 TTL、不引入外部依赖——只要对象没人用了，它就自己走。