运行pytest时出现ValueError: unknown configuration type: pathlist错误如何解决？

问题场景 #

在VS Code终端及Docker容器shell中，运行他人开发的Django Web应用的pytest命令时，均出现相同错误：ValueError: 'unknown configuration type: pathlist'，且pytest已作为项目依赖正常安装。

错误回溯 #

请补充具体错误栈信息：

# 示例格式
Traceback (most recent call last):
  File "/usr/local/bin/pytest", line 8, in <module>
    sys.exit(console_main())
  ...
  ValueError: 'unknown configuration type: pathlist'

当前pip依赖列表（pip freeze输出） #

请补充依赖包信息：

# 示例格式
pytest==7.4.0
pytest-django==4.5.2
Django==4.2.3
...

pytest.ini配置内容 #

请补充配置文件内容：

# 示例格式
[pytest]
DJANGO_SETTINGS_MODULE = myproject.settings
addopts = --reuse-db
python_paths = ./src

排查与解决办法 #

1. 优先检查版本兼容性 #

pathlist错误大概率是pytest核心与配套插件（如pytest-django）版本不兼容导致的：

• 对照项目的requirements.txt或pyproject.toml，强制重装指定版本的依赖：

  pip install -r requirements.txt --force-reinstall
  

• 若项目未锁定版本，尝试降级pytest到7.3.x稳定版，搭配对应版本的pytest-django：

  pip install pytest==7.3.2 pytest-django==4.5.2
  

2. 排查pytest.ini配置错误 #

配置文件的格式或拼写错误会触发该异常：

• 检查是否存在拼写错误的配置项，比如误将pythonpath写成python_paths（pytest仅支持单下划线格式的pythonpath）
• 逐行注释可疑配置，重新运行pytest，定位触发错误的配置行

3. 清理pytest缓存 #

缓存文件可能导致配置解析异常，执行以下命令清理后重试：

rm -rf .pytest_cache/

4. 排查自定义插件或conftest.py冲突 #

项目中的conftest.py或自定义pytest插件可能篡改了配置解析逻辑：

• 临时重命名conftest.py（如改为conftest_backup.py），重新运行pytest验证是否报错
• 查看依赖列表中的小众pytest插件，卸载后测试是否恢复正常

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