Python3.8升级至3.11后运行pytest报VendorAlias无find_spec属性错误排查

核心排查步骤 #

• 锁定依赖版本冲突
  执行poetry show --tree输出完整依赖链，重点检查：

  • pytest-django版本是否适配Python 3.10+（比如低于4.5.0的版本可能存在Python 3.10兼容问题）
  • pytest、django、pytest-xdist（你用到了-n 1参数）三者的版本匹配度，可直接对比同类正常项目的依赖版本差异。

• 定位错误触发源
  运行python -m pytest -xvs获取完整报错栈，确认VendorAlias所属模块——大概率是Django的vendor模块或第三方库的import别名逻辑，在Python 3.10+对importlib.util.find_spec的接口调整后失效。也可执行以下命令快速定位：

  python -c "import sys; print([k for k in sys.modules if 'VendorAlias' in k])"
  

• 重建干净虚拟环境
  清理残留的混合版本依赖，避免pyenv切换版本后环境中存在Python 3.8的遗留文件：

  poetry env remove 3.11.3
  pyenv local 3.11.3
  poetry install --no-root
  

• 排查项目自定义import逻辑
  大型代码库常存在自定义import钩子、sys.path修改或vendor包处理逻辑，检查项目中是否有：

  • 自定义模块别名工具（比如向sys.modules注入别名的代码）
  • 修改importlib行为的逻辑
  • 被手动修改过的第三方vendor包
    这些逻辑在Python 3.10+的import系统更新后可能触发兼容性问题。

• 最小复现验证
  创建空目录构建最小测试环境，逐步定位冲突依赖：

  mkdir test-reproduce && cd test-reproduce
  poetry init -n
  poetry add pytest pytest-django django pytest-xdist
  pyenv local 3.11.3
  python -m pytest -n 1
  

  若此环境正常，逐步添加原项目的依赖包，逐个测试找到冲突的具体依赖。

• 检查pytest-xdist兼容性
  你使用了-n 1启用pytest-xdist，旧版本的pytest-xdist可能在Python 3.10+下与pytest-django的插件逻辑冲突，尝试升级到最新版本：

  poetry update pytest-xdist
  

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