使用VideoBLIP实现视频字幕生成时遭遇Poetry配置错误求助

问题描述 #

参考VideoBLIP项目执行视频字幕生成任务，运行poetry install时触发错误：

RuntimeError: The Poetry configuration is invalid: - Additional properties are not allowed ('group' was unexpected)

环境信息：Python 3.10.12、Poetry 1.1.12，推测错误与pyproject.toml中的[tool.poetry.group.dev]配置段有关。曾尝试升级Poetry到1.2版本但出现新错误，已回退到1.1.12。

问题根因 #

Poetry 1.1.x版本不支持[tool.poetry.group.*]这类依赖分组配置，该特性是Poetry 1.2及以上版本才引入的，旧版无法识别group字段，因此抛出配置无效错误。

解决方案 #

方案一：升级Poetry到1.2+并修复新错误

1. 彻底升级到稳定的Poetry 1.2版本（例如1.2.2），执行命令：

   curl -sSL https://install.python-poetry.org | python3 - --version 1.2.2
   

2. 针对升级后出现的新错误，可尝试以下操作：
   • 执行poetry lock --no-update重新生成锁文件，规避依赖版本冲突
   • 检查pyproject.toml中的依赖版本约束，调整部分包的版本号以适配Python 3.10环境，再重新运行poetry install

方案二：修改pyproject.toml适配Poetry 1.1.12

如果不想升级Poetry，可将分组配置转换为旧版格式：

1. 打开pyproject.toml文件，找到[tool.poetry.group.dev.dependencies]段落
2. 将该段落内的所有依赖项，迁移到旧版的[tool.poetry.dev-dependencies]字段下
3. 删除整个[tool.poetry.group.dev]配置段
4. 保存文件后重新执行poetry install

示例修改：

• 修改前：

  [tool.poetry.group.dev.dependencies]
  pytest = "^7.0"
  black = "^22.0"
  

• 修改后：

  [tool.poetry.dev-dependencies]
  pytest = "^7.0"
  black = "^22.0"
  

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