如何配置extras_require覆盖依赖解决Poetry异步依赖安装缺失问题

该问题的核心是setuptools原生依赖声明逻辑与Poetry的依赖去重、Extra解析规则存在冲突：

• 当同一个依赖同时在install_requires和extras_require中声明时，setuptools生成的包元数据中，会优先保留install_requires里无Extra标记的版本条目，后续extras_require中声明的同包带Extra的条目，不会自动合并到已存在的依赖条目上。
• Poetry在解析这类来自setuptools的元数据时，会因为已经在基础依赖列表中识别到了some-custom-lib，判定该依赖的安装需求已被满足，不会再为其追加async相关的Extra组件，最终导致异步依赖没有被安装。
• 现有setup.py写法存在隐蔽bug：f"some-custom-lib{VERSION}"拼接后会生成some-custom-lib1.0.0这类无版本约束连接符的字符串，会被解析为不存在的独立包名，无法正确关联到实际的some-custom-lib包。

方案1：调整已发布库的setup.py依赖结构（根源修复） #

拆分依赖声明逻辑，利用setuptools支持的空Extra键（代表通用基础依赖），避免同包声明的覆盖冲突：

install_requires=[
    "attrs>=18.1.0,<=20.3.0",
    "structlog>=18.1.0,<22.0.0",
],
extras_require={
    # 空字符串键代表所有安装场景都会带上的基础依赖，不会与其他Extra的声明冲突
    "": [
        f"some-custom-lib=={VERSION}",
    ],
    "async": [
        f"some-custom-lib[async]=={VERSION}",
    ]
}

调整后重新发布my-lib，Poetry解析时可以正确识别：安装my-lib的async Extra时，会自动拉取带async组件的some-custom-lib版本。

方案2：在Poetry项目侧手动补充声明（无需修改已发布的依赖） #

如果暂时无法重新发布my-lib，可以在项目的pyproject.toml中手动显式声明带async Extra的some-custom-lib依赖，Poetry会自动合并相同包的Extra标记，不会产生版本冲突：

[tool.poetry.dependencies]
my-lib = {extras = ["async"], version = "~=1.0.0"}
# 手动显式声明带async组件的依赖，版本约束和my-lib的基础依赖保持一致
some-custom-lib = {version = "~1.0.0", extras = ["async"]}

额外注意事项 #

• 升级Poetry版本到1.2及以上，1.1版本对跨包Extra的合并逻辑存在已知缺陷，升级后对setuptools类打包的依赖解析兼容性会明显提升。
• 检查所有f-string格式的依赖声明，确保版本约束和包名之间有正确的连接符（如==、>=），避免出现包名拼接错误的问题。

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