多插件测试遇_pytest.pathlib.ImportPathMismatchError，求pyproject.toml解决方案

目录结构 #

src/some_package
└── plugin1
│   └── plugin1
│   └── tests
│   │   ├── __init__.py
│   │   └── unit
│   │       ├── __init__.py
│   │       ├── conftest.py
│   │       └── test_plugin1.py
└── plugin2
│   └── plugin2
│   └── tests
│   │   ├── __init__.py
│   │   └── unit
│   │       ├── __init__.py
│   │       ├── conftest.py
│   │       └── test_plugin2.py

当前pyproject.toml配置 #

[tool.pytest.ini_options]
markers = [
    "unittest: marks tests as unittest",
    "unittest-slow: marks tests as unittest that takes a long time",
]

执行报错 #

运行命令 poetry run pytest -v -m unittest 时触发错误：

E   _pytest.pathlib.ImportPathMismatchError: ('tests.unit.conftest', 'src/some_package/plugin1/tests/unit/conftest.py', PosixPath('src/some_package/plugin2/tests/unit/conftest.py'))

已尝试的方案 #

• 方案1：在pyproject.toml中添加addopts = "--import-mode=importlib"，出现新错误：

  E   ValueError: Plugin already registered under a different name: src/some_package/plugin1/tests/unit/conftest.py=<module 'tests.unit.conftest' from 'src/some_package/plugin2/tests/unit/conftest.py'>
  

• 方案2：添加testpaths = ["src/some_package/plugin2/tests", "src/some_package/plugin1/tests"]或pythonpath = "src/some_package/plugin1:src/some_package/plugin2"，报错未解决。

备注：单独运行单个插件测试（如 poetry run pytest -v -m unittest src/some_package/plugin2/tests）可正常执行。

可行解决方案 #

方案1：调整测试目录结构，避免模块名冲突 #

核心是让两个插件的测试模块拥有独立命名空间，具体操作：

1. 给每个插件的测试目录添加专属子目录：
   • 将plugin1/tests/unit移到plugin1/tests/plugin1_tests/unit下
   • 将plugin2/tests/unit移到plugin2/tests/plugin2_tests/unit下
2. 更新pyproject.toml的testpaths配置：

   [tool.pytest.ini_options]
   markers = [
       "unittest: marks tests as unittest",
       "unittest-slow: marks tests as unittest that takes a long time",
   ]
   testpaths = ["src/some_package/plugin1/tests", "src/some_package/plugin2/tests"]
   

调整后，两个conftest.py会被识别为plugin1_tests.unit.conftest和plugin2_tests.unit.conftest，彻底规避命名冲突。

方案2：合并conftest配置（逻辑兼容时适用） #

如果两个插件的conftest.py内容没有冲突、可以共用，将它们的逻辑合并到src/some_package/conftest.py中，然后删除两个插件各自的conftest.py文件，这样就不会出现重复模块的问题。

方案3：临时禁用全局conftest加载（应急方案） #

如果测试不依赖conftest.py中的fixture，可以在pyproject.toml中添加参数禁用所有conftest加载：

[tool.pytest.ini_options]
markers = [
    "unittest: marks tests as unittest",
    "unittest-slow: marks tests as unittest that takes a long time",
]
addopts = "--no-conftest"

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