直接用python:3.9基础镜像打包Flask会出问题，因生产环境无需开发依赖（如pytest、black）、调试工具（pip install -e .）及git/gcc等，它们使镜像体积翻倍、启动变慢、攻击面扩大；900MB镜像中约70%为构建残留。
为什么直接用 python:3.9 基础镜像打包 Flask 会出问题
因为生产环境不需要开发依赖（如 pytest、black）、源码调试工具（pip install -e .）、甚至 git 或 gcc —— 它们只会让镜像体积翻倍、启动变慢、攻击面扩大。你看到的 900MB 镜像，往往 70% 是构建时残留。
- 运行时只需
Flask、gunicorn、业务代码和配置文件 -
requirements.txt必须拆分：用requirements-prod.txt显式声明运行时依赖，不带-e .或注释行 - 避免在最终镜像中保留
/app/.git、/app/tests/、/app/docs/
多阶段构建 Dockerfile 怎么写才不踩坑
核心是两个阶段：构建阶段装依赖并编译（如有 C 扩展），生产阶段只拷贝 dist 或 site-packages 和精简后的代码。下面是最小可行写法：
FROM python:3.9-slim AS builder WORKDIR /app COPY requirements-prod.txt . RUN pip wheel --no-cache-dir --no-deps --wheel-dir /wheels -r requirements-prod.txt <p>FROM python:3.9-slim WORKDIR /app COPY --from=builder /wheels /wheels COPY --from=builder /usr/local/lib/python3.9/site-packages /usr/local/lib/python3.9/site-packages COPY . . RUN pip install --no-cache --find-links /wheels --no-index * && \ rm -rf /wheels CMD ["gunicorn", "--bind", "0.0.0.0:8000", "--workers", "2", "app:app"]</p>
- 不用
pip install -r requirements-prod.txt直接装，否则会触发在线源下载，破坏可重现性 -
--find-links /wheels --no-index强制只从本地 wheel 安装，跳过 PyPI - 别漏掉
CMD中的app:app—— 这是模块名:Flask 实例名，错一个字母就报ModuleNotFoundError - 如果用了
alembic或需要flask migrate，得额外把flask命令加进生产镜像（它不在Flask包里，而在flask包）
gunicorn 启动参数怎么配才稳
默认 flask run 是开发服务器，不能用于生产。用 gunicorn 时，以下参数不是可选，而是必须检查：
-
--bind 0.0.0.0:8000：必须绑定到0.0.0.0，不是127.0.0.1（Docker 内部网络不可达） -
--workers 2：建议设为 CPU 核数 × 2 + 1，但最小不要低于 2；单 worker 意味着一个请求卡住，整个服务挂掉 -
--timeout 120：防止长任务（如文件上传、报表生成）被误杀；默认 30 秒太激进 -
--preload：让 gunicorn 在 fork worker 前先导入应用，避免每个 worker 单独 import 导致的内存重复或初始化冲突 - 别在
app.py里写if __name__ == "__main__": app.run()，Docker 启动时会忽略它，但可能干扰 gunicorn 导入逻辑
如何验证容器化后行为一致
最常被忽略的是环境变量和文件路径差异。本地跑得好，容器里 500 错误，八成是这两处没对齐：
立即学习“Python免费学习笔记（深入）”；
- 检查
os.getenv("DATABASE_URL")是否传入容器：docker run -e DATABASE_URL=postgresql://...，别依赖.env文件（Docker 默认不加载） - 静态文件路径：本地用
app.static_folder = "static"，容器里确保COPY ./static /app/static，且 Nginx（如有）没覆盖/static路由 - 日志输出：Flask 默认打到 stdout 的日志，在容器里会被
docker logs捕获；但若用了RotatingFileHandler，路径要映射出来，否则日志消失 - 用
docker run --rm -it your-flask-app ls -l /app直接看容器内文件结构，比猜快十倍
多阶段构建真正省的不是时间，是排查“为什么线上和本地不一样”的时间。那个被删掉的 pyc 缓存、那个没 copy 进去的 config.toml、那个硬编码的 /home/user/app 路径——它们不会报错，只会让你凌晨三点还在改 Dockerfile。
