CI 上装依赖,pip 23.3 直接报 ERROR: conflicting dependencies,最后一行是 ResolutionImpossible。本地能装,是因为本地环境里早就装好了旧版本,pip 没动它。
我第一反应是 pip 版本太老,升到最新还是一样。用旧版解析器开关确实能装完,运行时却抛 ImportError,装出来的组合根本不能用,这个开关只是把冲突藏起来。
把依赖树打出来才看清,A 库要求 requests<2.29,B 库要求 requests>=2.31,两个都是间接依赖,requirements.txt 里根本没写 requests。只盯着顶层包看,永远看不出问题在哪。
改成 pip-tools 分层管理,requirements.in 只写直接依赖,pip-compile 生成带哈希的锁文件,冲突会在编译阶段就报出来,并指出是哪两个约束打架。解决方式不是硬压版本,而是把 B 库换成一个不绑 requests 的替代实现,A 库也升到支持新版的分支。
另一个坑是 urllib3,requests 和另一个 SDK 各自锁了不同的上限,升级 requests 之后 urllib3 被降级,TLS 1.3 的支持没了。锁文件里必须把间接依赖也钉死,CI 和线上用同一份。
锁文件生成后不要手改,任何一次手工调整都会让哈希对不上,安装时直接报错。要改就改 requirements.in 再重新编译,变更记录跟着提交走。
团队里还有人习惯在 CI 里加 --no-deps,装得快,但依赖缺失被藏到运行期,第一次请求才报 ModuleNotFoundError。这个参数只在明确知道后果时用。升级路径也排了顺序,先升不相关的小包,再动 requests 这条主线,每步跑一遍集成测试,出问题能立刻回滚到上一个锁文件。这套流程跑了半年,依赖相关的线上故障只出现过一次。锁文件一旦生成就当成产物,不再手改,这条规则也写进了团队文档。
确认口径:干净的 venv 里安装耗时 42 秒,pip check 输出无冲突;CI 缓存命中后 8 秒装完;连续构建 20 次,装出来的版本完全一致。
pip install pip-tools
pip-compile requirements.in -o requirements.txt
pip check 