Docker化Flask应用本地镜像运行正常 部署至Heroku后立即崩溃

故障原因 #

1. 启动命令参数丢失：从Heroku日志可见，容器启动时仅执行了python3命令，没有携带server.py参数，Python解释器无脚本可执行直接退出，返回状态码0，完全没有启动Flask服务。该问题是Heroku容器部署时默认覆盖Docker的CMD指令导致，原有ENTRYPOINT + CMD的组合规则在Heroku环境下不生效。
2. Procfile规则未加载：使用heroku.yml配置Docker构建时，Heroku会优先读取heroku.yml的配置，自动忽略根目录下的Procfile，所以你配置的gunicorn启动规则完全没有生效。
3. 潜在问题：原有配置用Flask自带的开发服务器启动，该服务器仅适合本地调试，稳定性、性能都不符合生产环境要求，也是后续可能出现崩溃的诱因。

解决方案 #

方案一：改用生产级WSGI服务器部署（推荐） #

1. 先在requirements.txt中添加gunicorn依赖：

# 原有依赖不变，新增下面一行
gunicorn==20.1.0

2. 修改Dockerfile，删除原有ENTRYPOINT和CMD配置，替换为gunicorn启动指令：

FROM python:3.9.4

ADD . /blockchain-py

WORKDIR /blockchain-py

RUN pip3 install -r requirements.txt

# 不需要硬编码暴露端口，Heroku会自动分配端口
CMD ["gunicorn", "--bind", "0.0.0.0:$PORT", "server:app", "--log-file=-"]

3. 保持现有heroku.yml配置不变，重新推送代码部署即可。

方案二：仅修复启动命令（仅适合临时测试） #

如果你不需要切换生产服务器，仅需要临时验证功能，可以把Dockerfile中原有ENTRYPOINT和CMD合并为一条指令，避免被Heroku覆盖：

# 删除原来的ENTRYPOINT和CMD，替换为下面一行
CMD ["python3", "server.py"]

该方案仍使用Flask开发服务器，不适合长期生产使用。

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