CircleCI初次使用失败排查:requirements.txt文件缺失导致构建报错
解决CircleCI构建时找不到requirements.txt的问题
嘿,我帮你拆解下这个构建失败的问题——核心原因就是你的circleci-project-setup分支里没有requirements.txt文件,但CircleCI的配置里两处都在引用它,所以才会报找不到文件的错误。咱们一步步来搞定:
1. 先搞懂为啥报错
从你贴的错误日志里能看到两个关键触发点:
- 计算缓存Key的时候,配置里用了
checksum "requirements.txt",系统找不到这个文件 - 执行安装命令
pip install --user -r requirements.txt时,同样找不到依赖清单文件
这说明你的项目仓库里缺了这个Python依赖管理的核心文件,而CircleCI的默认配置(或者你参考的文档示例)默认依赖它存在。
2. 两种快速修复方案
方案一:创建并提交requirements.txt
如果你的项目确实需要第三方Python依赖,直接在项目根目录新建这个文件,填上你需要的依赖包(比如flask==2.3.3这种),然后提交到分支:
# 创建空文件(如果没依赖的话也可以是空的) touch requirements.txt # 按需编辑文件添加依赖 git add requirements.txt git commit -m "Add requirements.txt for CircleCI build" git push origin circleci-project-setup
提交完再去CircleCI触发构建,应该就能正常跑了。
方案二:修改CircleCI配置,移除对该文件的依赖
要是你的项目暂时没有任何第三方依赖,那可以修改.circleci/config.yml,把用到requirements.txt的地方删掉:
- 找到包含
checksum "requirements.txt"的缓存配置块,直接删除或者用#注释掉 - 把原来执行
pip install的代码段,换成一个简单的验证命令,比如检查Python版本:
- run: name: Verify Python environment command: python --version && pip --version
改完配置后提交到分支,再重新触发构建就不会报错了。
3. 小提醒
你参考的官方入门文档可能默认假设用户已经有requirements.txt,但没明确提需要提前创建。后续如果用pipenv或者poetry这类工具管理依赖,记得同步修改CircleCI配置里的缓存Key和依赖安装命令哦。
内容的提问来源于stack exchange,提问作者yoshitaka okada




