使用Poetry管理无版本号PyPI依赖时报版本解析错误如何解决？

问题原因 #

1. 包名不匹配：你报错日志中指向的依赖名为waapi-client-python，但PyPI上公开的对应包实际名称为waapi-client，名称不一致会导致Poetry无法匹配到对应包。
2. 版本约束规则问题：
   • 你使用的^0版本约束在Poetry的语义化版本规则中，代表匹配>=0.0.0 <1.0.0的正式发布版本，如果包仅存在预发布版本（带alpha/beta/rc等后缀），Poetry默认不会匹配预发布版本。
   • 仅设置版本为any不会绕过预发布版本匹配限制，所以仍然会报错。

解决方法 #

Poetry完全支持这类场景，根据依赖的实际存储位置选择对应配置即可：

情况1：依赖已发布到公开PyPI，仅存在预发布版本 #

在pyproject.toml的依赖配置段添加allow-prereleases参数放开预发布版本限制：

[tool.poetry.dependencies]
# 写法1：匹配任意版本，包含预发布版
waapi-client = {version = "*", allow-prereleases = true}
# 写法2：直接指定具体的预发布版本号，稳定性更高
waapi-client = "0.1.0a1"

也可以直接执行命令自动写入配置：

poetry add waapi-client --allow-prereleases

情况2：依赖存储在私有PyPI源 #

先在pyproject.toml中添加私有源配置，再按照情况1的方式配置依赖即可：

[[tool.poetry.source]]
name = "private-pypi"
url = "私有源地址"
priority = "supplemental"

情况3：依赖未发布到PyPI，仅存在Git仓库或本地路径 #

直接指定依赖的Git源或本地路径即可：

[tool.poetry.dependencies]
# Git源写法，可自行指定branch/tag/commit
waapi-client = {git = "仓库地址", branch = "main"}
# 本地路径写法
waapi-client = {path = "本地包的目录路径"}

配置完成后执行poetry update即可正常完成依赖解析。

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