pytest环境下Python类重复导入导致isinstance判断失败问题咨询

Q1：Python原生机制会阻止同一模块重复导入，为什么会出现同一进程内同一模块生成多副本的情况？ #

Python的导入去重机制是基于sys.modules缓存实现的，仅当导入时使用的模块全路径字符串和sys.modules中已存在的缓存键完全匹配时，才会返回已有模块对象，否则会重新执行模块代码生成新的模块实例。
出现多副本的常见原因有三个：

• 同一个物理模块文件可通过多个不同的全路径导入：比如sys.path中同时存在/file/system和/file/system/foo两个路径，此时既可以用import foo.bar也可以用import bar导入同一个文件，生成两个不同的模块对象。你提到的sys.path无重复路径不等于没有多个可命中模块的父路径，这个是最常见的诱因。
• 代码中存在手动删除sys.modules['foo.bar']缓存的逻辑，删除后再次导入就会生成新的模块副本。
• 拼接的导入路径importpath存在隐性差异：比如部分场景下拼接的路径带额外前缀、或者存在大小写拼写差异（大小写不敏感系统会命中同一个文件，但sys.modules键大小写敏感，会生成不同缓存项）。

Q2：该问题的具体修复方案是什么？ #

根因定位 #

在importlib.import_module调用前加日志，打印每次的importpath和当前sys.path的完整列表，确认是导入路径不一致还是sys.path存在多命中路径的问题。

对应修复方案 #

• 统一全量导入路径：所有地方导入foo.bar都使用完全相同的全路径字符串，不要混用相对导入和绝对导入，不要通过添加多层父目录到sys.path来简化导入路径。
• 复用sys.modules缓存：修改你的导入方法，优先从sys.modules取已存在的模块，不存在再执行导入：

import sys
def import_module(self, module):
    importpath = ".".join([self._package, module])
    if importpath in sys.modules:
        module = sys.modules[importpath]
    else:
        module = importlib.import_module(importpath)
    self._modules[importpath] = module

• 清理错误缓存操作：检查所有业务和测试代码，删除手动删除sys.modules指定键的逻辑，如果确实需要重载模块，统一用同一个导入路径调用importlib.reload实现。
• 测试场景适配：如果是用pytest运行测试，启动时添加--import-mode=importlib参数，避免pytest自动修改sys.path导致的多路径导入问题。

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