Docker下gunicorn启动Flask未创建数据库表报UndefinedTable错误

两个核心问题导致报错：

1. 建表逻辑未触发：绝大多数Flask开发者会把SQLAlchemy的db.create_all()自动建表代码写在if __name__ == '__main__':的开发启动判断块里，你用python3 app.py run启动时会进入这个判断块，建表逻辑正常执行；换成gunicorn通过manage:app导入应用实例启动时，不会触发这个主函数判断块，建表代码完全没运行，因此查询时直接报表不存在。
2. 配置存在隐性错误：
   • 你配置的Postgres数据卷挂载路径错误，postgres:14-alpine官方镜像默认数据存储路径为/var/lib/postgresql/data，当前配置的/var/lib/postgresql/postgres/data是无效路径，会导致数据库初始化、数据持久化异常。
   • depends_on配置仅能保证db容器的进程被启动，不会等待Postgres服务完全就绪，应用启动时可能撞上数据库未完成初始化的窗口，导致连库、建表失败。

• 修正Postgres数据卷挂载路径，修改docker-compose中db服务的volumes配置：

volumes:
  - postgres_data:/var/lib/postgresql/data

• 调整app服务的启动命令，在启动gunicorn前显式执行建表逻辑，同时增加数据库就绪等待，避免启动时序问题：

command: sh -c "
  # 等待Postgres服务就绪
  while ! nc -z db 5432; do
    echo 'Waiting for database to be ready...'
    sleep 1
  done
  # 执行建表：如果用了Flask-Migrate就替换为flask db upgrade，没用就直接调用create_all
  python3 -c 'from app import db; db.create_all()'
  # 启动gunicorn服务
  gunicorn --bind 0.0.0.0:8000 manage:app
"

注意：如果使用上面的nc命令检测端口，需要在你的Dockerfile中安装netcat依赖，比如在Alpine基础镜像的构建步骤中加apk add --no-cache netcat-openbsd；如果不想加额外依赖，也可以用Python代码写简单的端口检测逻辑。

• 清理旧的错误持久化数据后重启服务：

docker compose down -v
docker compose up --build -d

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