如何在Python中实现异步模块的单实例初始化？

你当前的问题是异步初始化函数无法在模块顶层直接执行，导致无法像同步场景那样直接导出单实例。以下是几种可行的解决方案：

方案一：模块内维护缓存实例，修改初始化函数 #

在serv.py中添加模块级私有变量存储实例，修改init_serv函数判断实例是否已存在，不存在才创建：

_serv_instance = None

async def init_serv():
    global _serv_instance
    if _serv_instance is None:
        serv = Serv()
        _serv_instance = await serv.init_with_params()
    return _serv_instance

其他模块调用时，只需在异步上下文里await init_serv()即可，无论调用多少次都会返回同一个实例：

from serv import init_serv

async def some_func():
    serv = await init_serv()
    # 使用serv实例

方案二：将Serv封装为异步单例类 #

把单例逻辑直接整合到Serv类中，通过类方法提供实例获取接口：

class Serv:
    _instance = None

    async def init_with_params(self):
        # 原初始化逻辑
        pass

    @classmethod
    async def get_instance(cls):
        if cls._instance is None:
            cls._instance = cls()
            await cls._instance.init_with_params()
        return cls._instance

其他模块使用时，直接通过类方法获取实例：

from serv import Serv

async def some_func():
    serv = await Serv.get_instance()
    # 使用serv实例

方案三：应用启动时统一初始化，传递实例 #

如果你的应用有明确的异步入口（比如用asyncio.run启动的主函数），可以在入口处初始化一次实例，再传递给其他需要的模块：

main.py：

import asyncio
from serv import init_serv
from other_module import process_data

async def main():
    # 仅初始化一次
    serv = await init_serv()
    # 将实例传递给其他模块的函数
    await process_data(serv)

if __name__ == "__main__":
    asyncio.run(main())

other_module.py：

async def process_data(serv):
    # 直接使用传入的serv实例
    pass

这种方式避免了全局变量，更符合依赖注入的设计思想，适合结构清晰的大型应用。

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