Poetry构建时如何正确附加依赖实现无Poetry环境部署

你遇到的Invalid URL报错本质是依赖配置方式错误：

• 你在生产依赖段声明的notreal = {path = "./notreal-0.1.0-py3-none-any.whl"}属于本地文件系统路径依赖，Poetry执行build时不会将这类相对路径转换为pip可识别的标准依赖声明，最终生成的包元数据里会直接把这段相对路径作为依赖地址写入。当你脱离开发目录、在其他环境安装时，pip无法在对应路径找到wheel文件，自然抛出URL非法错误。
• 你将notreal同时声明在生产依赖和开发依赖段，会触发Poetry的依赖优先级解析混乱，进一步加剧构建产物的异常。

你当前本地用poetry run能正常运行，是因为Poetry在开发环境下自动处理了路径映射，但这个逻辑不会被带到构建产物里。

不需要额外安装Poetry插件，也不需要改现有目录结构，按以下步骤调整即可交付无Poetry依赖的可安装包：

1. 修正pyproject.toml依赖配置 #

修改services/one/pyproject.toml的依赖段，删除重复的notreal依赖声明，开发阶段直接引用monorepo内的源码目录即可：

[tool.poetry]
name = "one"
version = "0.1.0"
description = ""
authors = ["Bob Ross <bobross@gmail.com>"]

[tool.poetry.dependencies]
python = "^3.9"
# 开发阶段直接关联本地源码目录，develop=true表示用开发模式挂载，修改lib代码无需重复安装
notreal = {path = "../../libs/notreal", develop = true}

[tool.poetry.dev-dependencies]
pytest = "^5.2"

[build-system]
requires = ["poetry-core>=1.0.0"]
build-backend = "poetry.core.masonry.api"

改完之后在开发环境执行poetry install重新初始化环境，本地poetry run的运行逻辑和之前完全一致，不会受影响。

2. 标准化构建流程 #

Poetry默认的build命令只会构建当前项目的包，不会自动处理monorepo内部的依赖，你需要按顺序构建所有组件：

• 构建公共依赖库：进入libs/notreal目录，执行poetry build，将生成的dist/notreal-0.1.0-py3-none-any.whl留存备用。
• 构建业务服务：进入services/one目录，执行poetry build，拿到生成的dist/one-0.1.0-py3-none-any.whl。
• 组装交付物：将两个wheel文件放在同一个目录下，如果需要包含第三方依赖（比如你用到的其他pypi包），可以在该目录下执行pip download -r <(poetry export -f requirements.txt --without-hashes) -d .把所有依赖的wheel都下载到当前目录，最终整个目录就是完整的离线安装包。

3. 目标环境安装方式 #

在没有安装Poetry的目标环境上，进入交付物目录直接执行：

pip install *.whl

pip会自动解析所有包的依赖顺序完成安装，不会再出现路径非法的错误，安装完成后直接导入one包或者执行对应入口即可正常使用。

• 永远不要在[tool.poetry.dependencies]里直接写本地wheel的相对路径作为生产依赖，这类配置仅适用于本地临时测试，无法用于构建可分发的标准包。
• 同一个依赖不要同时声明在生产依赖和开发依赖段，否则会导致Poetry解析依赖时出现版本/路径覆盖问题。
• 如果后续monorepo新增更多公共库，只需要按顺序先构建底层公共库、再构建上层业务服务，把所有生成的wheel统一放到交付目录即可，不需要额外调整配置。

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