使用Poetry安装本地wheel包失败但pip可正常安装的问题排查

尝试使用Poetry v1.5.1安装本地wheel包，在pyproject.toml的[tool.poetry.dependencies]区块中添加配置：

my_package = {file = "/home/user/package.whl"}

执行后出现报错：

Because my_package (0.1.0) @ file:///home/user/package.whl depends on shapely (>=2.0.1,<3.0.0) which doesn't match any versions, my_package is forbidden.

单独执行poetry add shapely==2.0.1可正常完成安装；重建环境后，会以相同方式报错其他依赖包；但使用pip install /home/user/package.whl却可正常安装无任何问题。

• 依赖解析逻辑差异：Poetry的依赖解析逻辑比pip严格得多，它会提前校验所有依赖（包括间接依赖）的版本范围是否存在可匹配的包，只有确认所有依赖都能找到符合要求的版本才会开始安装。而pip采用宽松模式，只要能找到满足最低版本要求的包就会执行安装，不会做全范围预校验。
• 本地wheel元数据兼容性问题：你的本地wheel包的依赖元数据（比如METADATA文件中的依赖声明格式）可能存在细微不符合Poetry解析标准的情况，Poetry无法正确识别版本范围，但pip可以兼容这类不标准的元数据。
• Poetry的源或缓存异常：虽然单独安装shapely==2.0.1能成功，但解析本地wheel的依赖时，Poetry可能没有正确读取源的版本列表或缓存信息，导致误判该版本范围无匹配包。重建环境后缓存清空，这种误判会复现在其他依赖上。

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