如何在Python中实现单例模式且确保线程安全？-Python教程-PHP中文网

线程安全单例需用__new__+threading.Lock配合双重检查锁定（DCL）：外层无锁判空，内层加锁后再次判空并创建实例，确保仅一个实例；_lock必须为类变量且预初始化。

如何在python中实现单例模式且确保线程安全？

用 `new` + `threading.Lock` 实现最简线程安全单例

直接在 __new__ 中加锁是最直观、可控性最强的方式。它绕过了装饰器或模块级单例的隐式行为，所有实例化逻辑集中一处，调试和验证都方便。

常见错误是只锁住“判断是否已存在实例”那段，却没把整个实例创建过程包进锁里——这会导致多个线程同时通过 if cls._instance is None 判断，然后各自执行 super().__new__(cls)，最终生成多个实例。

正确做法是：锁必须包裹从判空到赋值的完整临界区。

import threading
<p>class Singleton:
_instance = None
_lock = threading.Lock()</p><pre class="brush:php;toolbar:false;">def __new__(cls):
    if cls._instance is None:
        with cls._lock:
            if cls._instance is None:  # 双重检查
                cls._instance = super().__new__(cls)
    return cls._instance

必须用双重检查（DCL）：外层无锁快速判断，内层加锁后再次判断，避免每次调用都抢锁
_lock 必须是类变量，且在类定义时就初始化，不能在 __new__ 里动态创建（否则锁对象本身就不唯一）
不要在 __init__ 中做耗时操作，因为 __init__ 每次都会执行；如需初始化逻辑，应放在 __new__ 中首次创建后触发

为什么不用 `@functools.lru_cache` 或模块单例？

这两种方式看似简单，但不满足“真正单例”的语义约束：

@lru_cache(maxsize=1) 本质是缓存返回值，它不控制类本身的构造过程；如果类有状态且依赖 __init__ 初始化，多次调用仍会反复执行 __init__，造成状态污染或资源重复申请
模块单例（如 singleton.py 里直接写 instance = MyClass()）在多线程导入场景下不安全：CPython 的模块导入本身是线程安全的，但 MyClass() 的执行时机不可控，若 __init__ 有竞态逻辑，依然会出问题
两者都无法应对子类继承场景——子类调用时不会复用父类的缓存或模块实例

使用 `call` 装饰器实现时的关键陷阱

用可调用类（如 SingletonMeta）作为元类或装饰器，容易忽略元类的继承传播与线程锁粒度问题。

Galileo python sdk

Galileo AI 平台 Python SDK 完整参考，用于评估、监控和保护 GenAI 应用，适用于构建 Python 应用。

下载

典型错误写法：SingletonMeta 中的 _instances 字典未按类区分，导致不同子类共享同一个实例；或者锁对象是实例级而非类级，失去互斥作用。

正确要点：

锁必须绑定到具体类（如 cls._lock），不能共用一个全局锁，否则不同单例类之间会无谓阻塞
_instances 字典键必须是 cls，确保 A 和 B（同继承自 SingletonMeta）各自拥有独立实例
元类的 __call__ 方法中，同样需要双重检查，且锁范围覆盖整个实例创建路径

实际项目中更推荐“显式工厂函数”替代硬编码单例

真正在业务代码里，硬编码单例常带来测试困难、依赖隐藏、生命周期难管理等问题。多数场景下，用一个带锁的工厂函数更灵活：

_db_instance = None
_db_lock = threading.Lock()
<p>def get_database():
global _db_instance
if _db_instance is None:
with _db_lock:
if _db_instance is None:
_db_instance = DatabaseConnection()
return _db_instance
</p>

这样做的好处：