如何结合Pipenv与Docker运行调试模式下的Flask应用？

问题根源 #

你用flask run启动应用时，app.py里if __name__ == '__main__'块的代码不会执行，所以app.run(debug=True)完全没起作用；另外，--debugger仅开启调试器，无法触发完整调试模式（含自动重载、代码热更新），Flask 2.0+需用--debug参数开启完整调试。

解决方法 #

方案1：修改Docker运行命令，直接开启调试模式

将启动命令替换为：

docker run --rm -ti --mount type=bind,source="$(pwd)",target=/home -p 5000:5000 -e FLASK_APP=app.py <IMAGE-NAME:HERE> flask run --port 5000 --host 0.0.0.0 --debug

• -e FLASK_APP=app.py：指定Flask应用入口文件，避免找不到应用
• --debug：开启完整调试模式，包含自动重载、调试器，启动日志会显示* Debug mode: on

方案2：通过Dockerfile设置环境变量开启调试

在Dockerfile的runtime阶段添加环境变量：

FROM base AS runtime

# Copy virtual env from python-deps stage
COPY --from=python-deps /.venv /.venv
ENV PATH="/.venv/bin:$PATH"
# 添加以下两行
ENV FLASK_APP=app.py
ENV FLASK_DEBUG=1

WORKDIR /home

# Install application into container
COPY . .

之后启动命令可简化为：

docker run --rm -ti --mount type=bind,source="$(pwd)",target=/home -p 5000:5000 <IMAGE-NAME:HERE> flask run --port 5000 --host 0.0.0.0

方案3：结合debugpy实现远程调试（可选）

如果需要远程调试，修改启动命令为：

docker run --rm -ti --mount type=bind,source="$(pwd)",target=/home -p 5000:5000 -p 5678:5678 -e FLASK_APP=app.py <IMAGE-NAME:HERE> python -m debugpy --listen 0.0.0.0:5678 -m flask run --port 5000 --host 0.0.0.0 --debug

• -p 5678:5678：映射debugpy调试端口
• python -m debugpy --listen 0.0.0.0:5678 -m flask run：通过debugpy启动Flask，允许远程调试工具连接

额外清理 #

删除Dockerfile中python-deps阶段的CMD pipenv debugpy，这行命令无实际作用（运行容器时你会手动指定启动命令）。

验证修改后，启动日志应显示* Debug mode: on，本地修改代码后容器内应用会自动重载。

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