容器化是fastapi/django应用上线最主流部署方式，需关注分层结构、多阶段dockerfile、环境配置分离、数据库就绪检查及健康监控。
用 FastAPI 或 Django 做 Web 应用，最终要上线运行，容器化（Docker）是最主流、最稳妥的部署方式。它能统一开发、测试、生产环境，避免“在我机器上是好的”这类问题。关键不是堆砌命令，而是理清结构：应用代码怎么组织、依赖怎么管理、配置怎么分离、数据库怎么连、如何健康检查、日志怎么收——这些才是落地时真正卡点的地方。
应用结构设计：按职责分层，不混在一起
别把 FastAPI/Django 项目和 Dockerfile、nginx 配置、docker-compose.yml 全塞进一个根目录。推荐这样分：
- app/：放核心代码（FastAPI 的 main.py 或 Django 的 manage.py 和 apps）
- docker/：放 Dockerfile、entrypoint.sh、gunicorn.conf.py（如果用 Gunicorn）、nginx.conf 等运行时配置
- deploy/：放 docker-compose.yml（本地调试/预发）、production.yml（生产环境，含 secrets、资源限制）
- scripts/：放初始化数据库、迁移脚本（如 init-db.sh）、健康检查 curl 命令等小工具
这种结构让团队协作清晰，CI/CD 流水线也容易复用不同环境的 compose 文件。
Dockerfile 写法：精简镜像，控制构建阶段
别直接 FROM python:3.11-slim 然后 pip install -r requirements.txt —— 这样镜像大、缓存差、有安全风险。推荐多阶段构建：
立即学习“Python免费学习笔记（深入）”；
- 第一阶段 builder：用完整 Python 镜像安装依赖（包括编译类包如 psycopg2-binary、uvloop），生成 requirements.lock
- 第二阶段 runtime：FROM python:3.11-slim-bookworm，只复制编译好的 site-packages 和源码，删掉 build 工具和缓存
- 固定基础镜像 tag（如 python:3.11.9-slim-bookworm），避免自动升级引发兼容问题
- 非 root 用户运行：RUN groupadd -g 1001 -f app && useradd -r -u 1001 -g app app；USER app
配置与敏感信息：环境变量 + .env + Docker secrets 分级管理
数据库地址、JWT 密钥、第三方 API Key 绝不能硬编码或提交到 Git：
- 开发时：用 python-decouple 或 pydantic-settings，读取 .env 文件（加到 .gitignore）
- 容器内：docker-compose.yml 中通过 environment 或 env_file 加载，但仅限非敏感字段（如 DEBUG=True）
- 生产环境：敏感值用 Docker secrets（swarm 模式）或 Kubernetes Secret；或用 HashiCorp Vault + init container 注入
- Django 注意 SECRET_KEY、DEBUG、ALLOWED_HOSTS 必须动态注入；FastAPI 同理，用 Settings 类统一管理
数据库与健康检查：启动顺序 + 可观测性不能少
Web 服务启动时，数据库可能还没 ready，直接报错退出会导致容器反复重启：
- 在 entrypoint.sh 里加等待逻辑：while ! nc -z db 5432; do sleep 2; done（适合简单场景）
- 更可靠的方式：用 docker-compose 的 healthcheck 定义数据库就绪条件，并设置 depends_on: { db: service_healthy }
- FastAPI 推荐实现 /health endpoint，返回 {"status": "ok", "db": true, "redis": false}；Django 可用 django-health-check 插件
- Nginx 做反向代理时，加上 health_check interval=3s rise=2 fall=3；避免把请求转给挂掉的实例
容器化不是终点，而是标准化运维的起点。从第一次 docker-compose up -d 跑通，到接入 Prometheus+Grafana 监控 uvicorn 进程数、SQL 查询耗时、HTTP 错误率，每一步都在降低线上故障概率。关键是把部署当成代码来维护——可版本、可测试、可回滚。
