You need to enable JavaScript to run this app. 如何修复Heroku部署含.py与.env文件应用时的buildpack不兼容错误
优惠活动
大模型
产品
解决方案
定价
更多

如何修复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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 17:06:02