Docker中Flask与PostgreSQL容器协同运行时数据库表未创建

核心问题1：db.create_all()未被执行 #

你的db.create_all()放在了if __name__ == '__main__'代码块中，但当前Dockerfile用flask run命令启动应用，此时__name__的值并不是__main__，这个代码块根本不会运行，导致数据库表从未创建。

核心问题2：模型类未被导入 #

即使create_all()执行了，如果你的models.py没有被导入到应用上下文里，SQLAlchemy不知道存在users表，也不会创建它。

额外问题：PostgreSQL容器未完全就绪 #

depends_on只保证db容器先启动，但PostgreSQL服务可能还在初始化（比如创建数据库、用户），此时Flask应用尝试连接会失败，后续也不会重试创建表。

解决方案1：调整启动方式，触发create_all() #

修改Dockerfile的启动命令，直接用python app.py启动，这样if __name__ == '__main__'块会被执行：

FROM python:3

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

EXPOSE 5000

# 替换原来的flask run命令
CMD ["python", "app.py"]

同时确保app.py里的app.run绑定0.0.0.0：

if __name__ == '__main__':
    with app.app_context():
        db.create_all()
        app.run(debug=True, host='0.0.0.0')  # 添加host参数

解决方案2：导入模型类，确保SQLAlchemy识别表结构 #

在app.py中导入你的模型类（比如User），否则db.create_all()不知道要创建哪些表：

from database.config import app, db
from database.models import User  # 必须导入所有需要创建的模型

if __name__ == '__main__':
    with app.app_context():
        db.create_all()
        app.run(debug=True, host='0.0.0.0')

解决方案3：确保PostgreSQL服务就绪后再启动Flask #

添加等待脚本，让Flask容器等待PostgreSQL完全可用后再启动：

1. 在项目根目录创建wait-for-postgres.sh脚本：

#!/bin/bash
set -e

host="$1"
shift
cmd="$@"

until PGPASSWORD=$POSTGRES_PASSWORD psql -h "$host" -U "$POSTGRES_USER" -d "$POSTGRES_DB" -c '\q'; do
  >&2 echo "Postgres is unavailable - sleeping"
  sleep 2
done

>&2 echo "Postgres is up - executing command"
exec $cmd

2. 给脚本添加执行权限：chmod +x wait-for-postgres.sh
3. 修改Dockerfile，复制脚本并调整启动命令：

FROM python:3

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
RUN apt-get update && apt-get install -y postgresql-client  # 安装psql客户端

COPY . .

EXPOSE 5000

CMD ["./wait-for-postgres.sh", "db", "python", "app.py"]

4. 在docker-compose.yml的flask_app服务中添加环境变量，传递Postgres参数：

flask_app:
    restart: always
    build:
        context: .
    ports:
        - "5000:5000"
    depends_on:
        - db
    environment:
        POSTGRES_USER: flask
        POSTGRES_PASSWORD: flask123
        POSTGRES_DB: flask_db
    networks:
        - my_network

验证步骤 #

1. 停止并删除现有容器：docker compose down -v
2. 重新构建并启动：docker compose up --build
3. 进入Postgres容器验证表是否存在：

docker exec -it <db-container-name> psql -U flask -d flask_db
# 执行查询：\dt 查看所有表，应该能看到users表

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