部署Docker镜像至Heroku出现H10应用崩溃报错如何解决

从运行日志判断，核心故障是Heroku容器启动时执行了错误的默认命令：平台拉起了无前台服务驻留的python3交互进程，进程启动后直接以状态码0退出，反复触发崩溃重启，最终路由层返回H10（App crashed）错误、503服务不可用状态。
现有配置存在4个明确问题：

• 容器部署模式下Heroku不会读取项目根目录的Procfile，你的Dockerfile既没有定义CMD/ENTRYPOINT启动指令，依赖列表里也没有明确安装gunicorn，因此平台回退到Python基础镜像的默认启动命令python3，进入交互模式后立刻退出。
• 本地调试用的docker-compose.yml在Heroku部署时完全不生效：Heroku的web Dyno是单容器运行单元，不会自动编排启动MongoDB容器，也不支持links方式做容器网络关联。
• 现有Dockerfile使用Python3.7基础镜像，和预期的Python3.10运行环境不符。
• Flask的secret_key配置写在if __name__ == '__main__'判断块内，后续就算用gunicorn启动服务，这部分配置也不会加载，会触发业务逻辑异常。

1. 重写Dockerfile配置 #

容器部署时启动命令以Dockerfile内定义的CMD/ENTRYPOINT为准，不需要依赖Procfile，修改后的Dockerfile如下：

# 匹配需求使用Python3.10轻量基础镜像
FROM python:3.10-slim
# 设置工作目录
WORKDIR /app
# 先复制依赖文件，利用Docker构建缓存加速后续构建
COPY requirements.txt .
# 安装依赖，确保requirements.txt内包含gunicorn、flask、pymongo等项目需要的包
RUN pip install --no-cache-dir -r requirements.txt
# 复制剩余项目代码到镜像内
COPY . .
# 核心：明确指定web服务启动命令，绑定Heroku动态分配的PORT端口
CMD gunicorn --bind 0.0.0.0:$PORT app:app

注意：app:app格式为模块名:Flask实例名，如果你的Flask实例定义在app.py文件中且变量名为app可直接使用；如果你要通过wsgi.py入口启动，确保文件内正确导出app实例后，将启动命令改为gunicorn --bind 0.0.0.0:$PORT wsgi:app即可。

2. 修正Flask代码逻辑 #

把全局配置移出if __name__ == '__main__'判断块，保证无论用什么方式启动服务，配置都能正常加载：

import os
from flask import Flask

app = Flask(__name__)
# 全局配置移到判断块外
app.secret_key = 'mysecret'

# 此处写路由、业务逻辑代码

if __name__ == '__main__':
    port = int(os.environ.get('PORT', 5000))
    app.run(host='0.0.0.0', port=port)

如果保留wsgi.py作为入口，确保文件内容如下：

from app import app

if __name__ == "__main__":
    app.run()

3. 调整MongoDB部署方案 #

Heroku web Dyno不支持多容器编排，且文件系统是临时存储（重启后所有写入数据会被清空），不能在同一个web容器内启动MongoDB服务：

• 选用Heroku平台的MongoDB附加服务，或者MongoDB Atlas等第三方云Mongo服务
• 将代码中写死的本地Mongo连接地址（如mongodb://localhost:27017、mongodb://db:27017）改为从环境变量读取云服务连接串，Heroku会自动将附加服务的连接信息注入到容器环境变量中。

4. 本地验证后重新部署 #

不要直接修改配置就推送，先本地构建镜像验证启动逻辑正常：

# 本地构建镜像
docker build -t ttcv1-local .
# 本地启动容器测试，指定PORT端口
docker run -e PORT=5000 -p 5000:5000 ttcv1-local

本地访问http://localhost:5000确认服务正常响应后，再执行Heroku部署命令：

heroku container:push web -a ttcv1
heroku container:release web -a ttcv1
# 实时查看启动日志，确认没有报错
heroku logs --tail -a ttcv1

如果日志中出现gunicorn的启动提示Listening at: http://0.0.0.0:xxxx，说明服务启动正常，不会再出现之前的崩溃问题。

• Heroku容器部署必须绑定0.0.0.0地址和平台动态分配的$PORT端口，不能绑定127.0.0.1，也不能写死固定端口，否则路由层无法转发请求会触发H10错误。
• 不需要额外创建heroku.yml文件做容器配置，直接在Dockerfile中写全构建、启动逻辑即可，避免多配置文件冲突。
• 部署前确认requirements.txt包含所有依赖包，不要漏装gunicorn、pymongo等运行必需的组件。

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