Pip为何在Python符合版本约束时仍报错提示版本不匹配
问题本质与根因
这是Pip v21.0.1 版本内置依赖解析器的已知功能性缺陷,你配置的python_requires约束、当前Python版本和要求的匹配关系本身完全没有问题,问题完全出在Pip的报错与归因逻辑上,具体体现在两点:
- 错误的责任归因:Pip从20.3版本开始默认启用的新版依赖解析器,在遍历完整依赖树校验Python兼容性时,只要发现任意一个节点(包括用户没直接接触的传递依赖)的
python_requires不匹配当前环境,就会直接终止解析流程,但这个版本的解析器没有做精确的节点定位,会把所有版本不匹配的责任统一归到用户输入的顶层安装目标包上,完全忽略真正触发不匹配的底层依赖。
对应你的测试场景:Python 3.9环境下安装package-a时,实际是传递依赖package-b的<3.9约束不满足环境要求,但Pip没有把错误指向package-b,反而默认把报错主体写成顶层的package-a,误导你以为是package-a本身不支持3.9版本。 - 不经校验的报错文案:Pip在抛出版本不匹配的错误提示时,不会校验文案里展示的版本约束范围和当前Python版本的实际匹配关系,只会随机从依赖树的节点缓存中取一段约束字符串拼到报错里。这就直接造成了你遇到的矛盾现象:不管是自己开发的包约束
>=3.6, <3.9,还是其他包的约束!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.9,>=2.7,3.8.7 明明完全落在这些约束的合法范围内,却被提示版本不满足要求。本质上Pip根本没有核对这段写在报错里的约束和当前版本的匹配关系,只是因为检测到依赖树里存在某个不匹配的节点,就随便拿了一段缓存里的约束字符串凑成报错。
问题判定与修复情况
- 这确实是Pip本身的bug,不是你开发的包存在配置错误。你给包设置的版本约束逻辑正确,3.8.7版本也确实符合你列出的所有版本范围要求。
- 这个缺陷在Pip v21.1及后续版本中已经被修复。修复后的解析器会明确标注是哪一个具体的包的Python版本约束与当前环境不匹配,同时会对报错中展示的版本范围做逻辑校验,不会再出现"明明符合范围却提示不兼容"、"将传递依赖的问题错误归责给顶层安装包"的错位提示。
内容的提问来源于stack exchange,提问作者mipadi
相关产品推荐
相关产品推荐

