Python中如何主动将singleton（单例）对象从内存中释放？

单例内存释放解决方案 #

你当前使用的装饰器中instances是闭包内部变量，外部默认无法访问，只要给装饰器额外暴露一个清空接口即可实现手动释放的需求。

改造后的装饰器实现

def singleton(cls):
    instances = {}
    def getinstance():
        if cls not in instances:
            instances[cls] = cls()
        return instances[cls]
    # 新增清空实例的方法，暴露给外部调用
    def clear():
        instances.clear()
    getinstance.clear = clear
    return getinstance

@singleton
class MyClass:
    ...

使用方式

• 获取单例实例的逻辑和之前完全一致：obj = MyClass()
• 需要释放内存时直接调用MyClass.clear()即可，执行后instances字典会被清空，只要没有其他代码位置持有该单例的引用，Python垃圾回收器会自动回收对应的内存空间。

FastAPI场景适配建议 #

如果在FastAPI项目中使用，推荐把清空逻辑绑定到服务的 shutdown 生命周期钩子中，服务停止时会自动执行释放，无需手动调用：

from contextlib import asynccontextmanager
from fastapi import FastAPI

@asynccontextmanager
async def lifespan(app: FastAPI):
    # 服务启动逻辑可以放在此处
    yield
    # 服务停止时自动执行单例释放
    MyClass.clear()
    # 存在多个单例时可以依次调用对应clear方法

app = FastAPI(lifespan=lifespan)

补充说明 #

• 正常脚本执行结束后整个进程会退出，操作系统会自动回收进程占用的所有内存，不存在单例内存泄漏的问题，手动释放仅适用于进程运行期间需要主动销毁单例回收资源的场景
• 如果你的单例类持有数据库连接、网络套接字、文件句柄等特殊资源，建议在清空字典前先调用实例的资源销毁方法，可将clear方法改造为：

  def clear():
      for instance in instances.values():
          if hasattr(instance, "close"):
              instance.close()
      instances.clear()
  

内容的提问来源于stack exchange，提问作者El Dude