运行pytest时从包导入模块导致Pydantic验证失败的原因

问题根源 #

这是Python模块导入机制和Pydantic类型验证逻辑共同作用的结果：

• Python中，同一个文件如果通过不同的导入路径被加载，会被视为两个独立的模块。
• 你的代码里，from md_enums import MiscBuildType 和 from metadata_manager.md_enums import MiscBuildType 是两种不同的导入路径，Python会加载两次md_enums.py文件，生成两个完全独立的模块对象。
• 模块中的MiscBuildType枚举类会被实例化为两个不同的类，它们的__module__属性和内存地址都不一样。
• Pydantic验证枚举类型时，是严格匹配类的身份的——你的VersionInfo模型依赖的是md_enums.MiscBuildType（从misc_build.py的导入路径推断），所以用另一个路径导入的枚举实例验证时，会被判定为类型不匹配，触发验证错误。

验证差异的方法 #

在测试代码中加入以下代码，可以直观看到两个枚举类的差异：

from md_enums import MiscBuildType as BuildType1
from metadata_manager.md_enums import MiscBuildType as BuildType2

# 打印内存地址，会显示不同的值
print(id(BuildType1))
print(id(BuildType2))

# 打印模块名称，路径不同
print(BuildType1.__module__)  # 输出: md_enums
print(BuildType2.__module__)  # 输出: metadata_manager.md_enums

解决办法 #

1. 统一项目内的导入路径：整个项目中只使用一种方式导入MiscBuildType，要么全用from md_enums import ...，要么全用from metadata_manager.md_enums import ...。
2. 规范包结构：确保metadata_manager是标准Python包（包含__init__.py），并且项目的sys.path中只包含metadata_manager的父目录，避免路径冲突导致重复加载。
3. 排查conftest.py：再次检查metadata_manager目录及父目录的conftest.py，确认有没有修改sys.path的代码——这类操作可能无意中引入了重复的模块路径。

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