flask容器化部署需绑定0.0.0.0并显式暴露端口，docker-compose的depends_on仅控启动顺序不等服务就绪，环境变量需显式加载，静态文件挂载易覆盖导致404。
Flask 本身不是为集群设计的，docker-compose 也不是集群编排工具——它只负责单机多容器协调。真要搭“集群”，得明确你指的到底是「多实例负载分发」还是「服务高可用依赖组合」。绝大多数人卡在这一步，是因为混淆了开发联调环境和生产集群的边界。
Flask 容器必须绑定 0.0.0.0 并显式暴露端口
默认 app.run() 只监听 127.0.0.1:5000，进容器后外部根本连不上。
- 启动时必须加
host='0.0.0.0'，例如：app.run(host='0.0.0.0', port=5000) -
docker-compose.yml的ports字段不能省或写错：- "5000:5000"是正确写法；- "5000"只映射内部端口，不对外暴露 -
EXPOSE 5000在 Dockerfile 中只是元数据，不影响实际网络行为，别依赖它
依赖服务（如 Redis、PostgreSQL）启动后无法立即连接
depends_on 只控制启动顺序，不等服务 ready。Flask 容器一启动就去连 Redis，大概率报 ConnectionRefusedError 或 psycopg2.OperationalError。
- 在 Flask 启动逻辑里加重试：用
socket.connect()尝试目标地址+端口，比time.sleep(5)更可靠 - 或者给依赖服务配
healthcheck，例如 PostgreSQL 镜像支持：interval: 30s、timeout: 3s、retries: 3 - 别在
__init__.py或create_app()顶层直接初始化数据库连接，移到请求处理或应用工厂内延迟加载
环境变量从 .env 注入但 Flask 进程读不到
docker-compose.yml 的 env_file 只把变量传进容器环境，Python 进程不会自动加载成 os.environ 键值——除非你显式调用 load_dotenv()。
- 确保 Flask 代码里用
os.getenv('DB_URL')读取，而不是硬编码或指望python-dotenv自动生效 -
env_file: .env的路径是相对于docker-compose.yml的，写错会导致变量为空字符串 - 本地开发用
flask run时，.env不会被 Compose 加载机制触发，行为天然不一致——这点最容易被忽略
静态文件 404 是因为 volume 挂载覆盖了 static/ 目录
Dockerfile 构建时 COPY . /app 把本地 static/ 打包进镜像；但运行时又用 volume 挂载 ./app:/app，整个 /app 被替换，原有 static/ 就丢了。
- 要么改 volume 挂载粒度：
./app:/app/app，留出/app/static不被覆盖 - 要么删掉 Dockerfile 中的
COPY . /app，完全依赖挂载，但需确保本地有static/和templates/目录 - 检查
app.static_folder是否仍指向./static，路径没变，但内容已被挂载清空
真正让 Flask + docker-compose “跑起来”的障碍，从来不是 YAML 写错几行，而是 Python 进程对网络地址、环境变量、文件路径的真实感知方式——这些细节一旦错位，错误现象往往滞后、模糊、难以复现。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
