单例类测试失败的典型现象是测试用例间相互污染，根本原因是单例实例在模块生命周期内常驻内存且pytest默认不重载模块；解决方法包括手动清除类变量（如Singleton._instance = None）或使用function作用域fixture重置，需准确定位状态存储位置并验证清理效果。
pytest中单例类测试失败的典型现象
测试用例之间相互污染，比如第二个测试发现 Singleton.instance() 返回的是前一个测试修改过的对象，而不是全新初始化的状态。根本原因是单例实例在模块生命周期内常驻内存，pytest 默认不重载模块，_instance 类变量不会自动清空。
手动清除单例内部状态（最直接有效）
适用于手写单例（如用 __new__ 或类变量缓存），核心是让单例“退回到未初始化状态”。操作必须在每个测试前后执行，推荐用 pytest 的 setup_method / teardown_method 或 fixture。
- 确认单例存储位置：常见为私有类变量如
_instance、__instance或模块级变量 - 在
teardown_method中显式设为None：def teardown_method(self, method): Singleton._instance = None - 若单例依赖外部状态（如文件、全局 dict），需一并清理，否则下次
instance()仍可能复用旧数据
用 pytest.fixture 重置单例（更符合测试习惯）
把单例重置逻辑封装成函数 fixture，作用域设为 "function"，确保每个测试独占干净实例。注意：不能用 autouse=True 自动注入，否则可能干扰不需要重置的测试。
- 定义 fixture 示例：
@pytest.fixture(autouse=True, scope="function") def reset_singleton(): Singleton._instance = None yield # 可选：恢复原始状态（如需验证多次调用行为） - 若单例构造函数有副作用（如连接数据库），建议在 fixture 中也 mock 掉
__init__或关键依赖，避免测试变慢或不稳定 - 多个单例类共存时，别图省事全设
autouse=True；应按需显式声明 fixture 参数，提高可读性
避免 monkeypatch 失效的坑
有人试图用 monkeypatch.setattr(Singleton, "_instance", None)，但容易失败——因为单例逻辑可能在类定义时就已绑定，或使用了 __dict__ 直接赋值绕过属性访问。
立即学习“Python免费学习笔记（深入）”；
- 优先直接赋值：
Singleton._instance = None，比 monkeypatch 更可靠 - 如果单例用了
@classmethod+cls._instance，且类被继承，需确认清理的是目标类而非父类的_instance - 用
print(Singleton._instance is None)在 teardown 后加一行验证，避免“以为清了其实没清”
单例测试最难的不是重置动作本身，而是准确识别它到底把状态存在哪——有时藏在闭包里、有时是模块级变量、有时甚至用 weakref 缓存。动手前先 grep 一遍类定义和 import 链，比硬试更快。
