Pip安装Poetry构建的TestPyPI包报依赖版本不存在如何解决

你遇到的TestPyPI包安装时依赖拉取失败，和Poetry配置写法、依赖版本约束规则无关，是TestPyPI的默认索引规则导致的：TestPyPI作为PyPI的测试环境，默认不会主动从正式PyPI拉取公共依赖包，只会检索自身索引存储的包资源。你看到的报错里requests仅存在2.5.4.1版本，就是因为TestPyPI没有同步正式PyPI上requests的全量版本，自然匹配不到你声明的版本要求。

• 安装TestPyPI上发布的个人包时，显式指定索引规则：将TestPyPI设为目标包的拉取源，正式PyPI设为公共依赖的兜底拉取源，执行安装命令：

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ 你的包名

参数说明：--index-url 指定主索引源，pip会优先从该地址检索你要安装的目标包；--extra-index-url 指定补充索引源，主源找不到的依赖会自动到该地址检索，刚好适配「从TestPyPI装自研包、从正式源拉公共依赖」的测试场景。

• 本地校验构建产物正确性：执行poetry build完成构建后，解压dist目录下生成的.whl格式包，查看包内METADATA文件的Requires-Dist字段，确认你在pyproject.toml中声明的所有依赖、对应版本约束都已正确写入，排除构建环节漏打依赖元数据的问题。
• 安装前确认当前环境Python版本符合^3.10的约束（即版本>=3.10,<4.0），避免Python版本不兼容导致的依赖匹配失败。

• 你看到报错里pip尝试拉取requests==2.28.1，但pyproject.toml中写的是2.28.0属于正常现象：Poetry的^版本约束允许安装同主版本下兼容的更高补丁版本，不是配置错误。
• 不需要反复调整依赖版本约束松紧度、切换构建后端、升降级pip/setuptools版本，这类操作对该问题无效，只要索引源配置正确即可正常拉取依赖。
• 不建议全局配置pip把TestPyPI加为默认源，会导致后续安装正式公网包时出现串源、版本匹配异常的问题，测试安装时显式带参数即可。

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