Python多模块全局类对象不一致：单测正常全量测试失败

我之前也踩过类似的坑！你遇到的核心问题其实是Python模块导入机制导致的重复导入——同一个MockSettings类在不同模块里被当成了完全不同的对象，哪怕它们运行在同一个进程里。

先把你的简化示例整理清晰：

mock_settings.py #

class MockSettings(object):
    fake_random = False

views.py #

import os
import random
from django.http import HttpResponse
from mock_settings import MockSettings

def func(request):
    print(os.getpid(), id(MockSettings))
    if MockSettings.fake_random:
        return HttpResponse('123')
    else:
        return HttpResponse(str(random.randint(1000)))

tests.py #

import os
from django.test import TestCase
from mock_settings import MockSettings
from django.urls import reverse

class FuncTest(TestCase):
    def test_func(self):
        print(os.getpid(), id(MockSettings))
        MockSettings.fake_random = True
        response = self.client.get(reverse('func'))
        self.assertEquals(response.content.decode(), '123')  # 单跑正常，全量测试失败

你提到的两个奇怪现象：

• 单独运行测试时，tests.py和views.py里的MockSettings id相同；全量测试时，pid一致但类id不同，导致fake_random值不一致
• 新项目无法复现，注释其他测试后问题仍存在

问题根源 #

这本质是模块被重复导入，生成了不同的模块实例。Python中，模块的身份由它在sys.modules中的键决定——如果同一个模块被通过不同路径导入（比如一次用from mock_settings import ...，一次用from myapp.mock_settings import ...），或者测试运行环境把项目的多个目录都加入了sys.path，Python就会把它们当成两个独立的模块，各自加载一次，里面的MockSettings类自然就是两个完全不同的对象。

单独运行测试时，测试脚本的导入路径单一，模块只会被加载一次；但全量测试时，可能其他测试用例的导入方式修改了sys.path，或者某个测试提前用不同路径导入了mock_settings，导致后续导入的是另一个模块实例。

解决方案 #

1. 统一导入方式：项目中所有地方都使用绝对导入，比如from myproject.myapp.mock_settings import MockSettings，避免相对导入或不同路径的导入方式混用。
2. 检查sys.path设置：确保测试运行时，不要把项目的根目录和子目录同时加入sys.path（比如Django测试中，依赖框架默认配置即可，不要手动修改sys.path）。
3. 改用模块级单例：Python的模块本身就是天然的单例，你可以直接把配置放在模块里，而非类的静态字段，这样即使模块被误导入多次，只要sys.modules里的键一致，就会复用同一个模块实例：

   # mock_settings.py
   fake_random = False
   

   之后在views和tests里直接导入这个变量即可。
4. 使用专业Mock工具：放弃自己维护全局Mock配置，改用unittest.mock.patch直接替换目标函数里的依赖，比如：

   def test_func(self):
       from unittest.mock import patch
       with patch('views.MockSettings.fake_random', True):
           response = self.client.get(reverse('func'))
           self.assertEquals(response.content.decode(), '123')
   

   这种方式直接针对目标位置的变量进行Mock，完全不受导入问题影响。

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