讲师中心 微信公众号
AI工具推荐 视频效率加速

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

夜芳酱_9719

夜芳酱_9719

发布时间:2026-09-16 06:15:40

|

441人浏览过

|

来源于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

立即学习“Python免费学习笔记(深入)”;

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

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

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

testing-python
testing-python

使用pytest编写和评估有效的Python测试。适用于编写测试、审查测试代码、调试测试失败或提高测试覆盖率。

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

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

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

典型错误写法: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

这样做的好处:

  • 实例化逻辑完全暴露,便于打桩、替换、延迟初始化
  • 锁对象和实例变量命名清晰,不依赖类机制,减少元编程心智负担
  • 可以轻松支持“按配置决定是否单例”,比如测试环境每次返回新实例,生产环境才走单例路径

真正的难点不在“怎么写单例”,而在于确认“是否真的需要单例”。数据库连接池、日志器、配置管理器这些有明确全局唯一语义的对象才适合;普通业务对象强行套单例,往往只是掩盖了设计缺陷。

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1691

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

4244

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1669

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

24657

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3007

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3047

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1163

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

C++运算符基础入门
C++运算符基础入门

本专题详细讲解了C++运算符的类型、语法与使用方法,涵盖算术运算符、关系运算符、逻辑运算符、位运算符、赋值运算符、条件运算符及其他特殊运算符,并通过代码示例解析优先级与结合性。

0

2026.10.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn