Flask+Gunicorn部署Heroku失败求助：本地正常线上报错

问题根源 #

你遇到的核心问题是Heroku Python buildpack的依赖优先级逻辑：当项目中同时存在requirements.txt和Pipfile/Pipfile.lock时，Heroku会优先使用Pipenv来管理依赖。但你的Pipfile.lock里的default依赖列表是空的，既没有gunicorn也没有Flask，所以部署时完全没安装这些必要的包——这就解释了为什么会出现bash: gunicorn: command not found（状态码127），以及后续启动python app.py时的Flask导入错误（H10崩溃）。

解决方案（二选一即可） #

方案1：继续使用requirements.txt管理依赖

如果你更习惯用传统的requirements.txt，只需要让Heroku忽略Pipenv文件：

• 从项目中删除或者重命名Pipfile和Pipfile.lock（比如改成Pipfile.bak和Pipfile.lock.bak）
• 检查你的requirements.txt，确保包含所有运行必需的依赖，比如：

  Flask==2.0.3  # 替换成你实际使用的版本
  gunicorn==19.7.1
  

• 提交修改后的代码到Git，重新部署：

  git add .
  git commit -m "Remove Pipenv files, ensure requirements.txt has all dependencies"
  git push heroku main
  

方案2：改用Pipenv管理依赖（Heroku官方推荐）

如果想切换到Pipenv（更现代的依赖管理方式），按以下步骤操作：

1. 本地安装Pipenv（如果还没装）：pip install pipenv
2. 在项目根目录下安装所需依赖：

   pipenv install flask gunicorn==19.7.1
   

   这会自动更新你的Pipfile和Pipfile.lock，把Flask和gunicorn添加到default依赖列表中。
3. 确认Pipfile里的Python版本和你本地一致（你当前指定的是2.7.15，注意Python 2已经停止官方维护，如果可以的话建议升级到Python 3）
4. 提交更新后的Pipfile和Pipfile.lock到Git：

   git add Pipfile Pipfile.lock
   git commit -m "Add Flask and Gunicorn to Pipenv dependencies"
   git push heroku main
   

验证部署结果 #

部署完成后，你可以通过以下命令确认依赖是否正确安装：

heroku run pip list

输出里应该能看到gunicorn和Flask的条目。如果还是有问题，可以查看详细的build日志：

heroku logs --tail

内容的提问来源于stack exchange，提问作者acd37