如何修复Heroku部署含.py与.env文件应用时的buildpack不兼容错误
Heroku GitHub关联部署报错排查
实际遇到的场景
完成GitHub仓库与Heroku应用的绑定后,已将项目的Python代码文件、.env配置文件推送至仓库,手动触发对应分支的部署流程,构建阶段直接报错终止,抛出的原始日志如下:
-----> Building on the Heroku-20 stack -----> Using buildpacks: 1. heroku/python 2. https://github.com/niteoweb/heroku-buildpack-shell.git -----> App not compatible with buildpack: https://buildpack-registry.s3.amazonaws.com/buildpacks/heroku/python.tgz ! Push failed
故障根因
Python官方构建包执行项目校验逻辑时,没有识别到符合要求的Python项目标识,触发检测失败规则,直接判定当前应用与Python构建包不兼容,中断构建流程。
可直接落地的修复步骤
- 检查GitHub仓库根目录的文件完整性:Heroku Python构建包仅会扫描根目录下的四类可识别文件:
requirements.txt、Pipfile、setup.py、pyproject.toml,只要根目录下完全没有这类文件,就会直接触发不兼容报错。注意不要把这类标识文件存放到嵌套子目录中,也不要仅推送.py代码文件、漏传上述标识文件 - 核对部署分支匹配性:确认手动触发部署的分支,与实际存放项目代码、标识文件的分支完全一致,错选空分支、仅含初始README的分支都会触发检测失败
- 调整构建包加载顺序:将
heroku/python调整到构建序列的第一位,避免前置的自定义shell构建包提前拦截校验流程 - 额外注意:
.env属于本地环境变量配置文件,不会被Python构建包识别为有效项目标识,无法替代上述四类标识文件的作用
内容的提问来源于stack exchange,提问作者Tim
相关产品推荐
相关产品推荐

