Docker中执行Alembic异步迁移报错：表不存在

核心疑点：执行的SQL与本地代码不一致 #

你本地编写的升级逻辑是给products表添加status字段，但报错里执行的SQL却是ALTER TABLE orders ADD COLUMN state VARCHAR(255)——这说明Docker环境中运行的Alembic修订版本和你本地的最新版本不匹配。

解决步骤： #

1. 确认Docker镜像包含最新修订文件

   • 检查Dockerfile或docker-compose.yml，确保Alembic的versions目录被正确复制到镜像中。修改本地修订文件后必须重新构建镜像：

     docker compose up -d --build
     

   • 进入容器查看versions目录内容，确认最新的修订文件存在：

     docker compose exec container_name ls -l alembic/versions/
     

2. 验证数据库连接正确性

   • 检查Alembic的alembic.ini或配置文件，确认Docker环境中使用的数据库URL和PostgreSQL容器的配置一致（包括数据库名称、用户名、密码、端口）。
   • 手动进入PostgreSQL容器，查看目标表是否存在于指定的数据库中：

     docker compose exec postgres_container psql -U username -d dbname
     # 执行SQL查看表
     \dt
     

3. 确保数据库就绪后再执行迁移

   • PostgreSQL容器启动后需要一定时间初始化，直接执行迁移可能会遇到表未创建的问题。可以在执行迁移前添加等待逻辑：

     docker compose exec container_name sh -c "until pg_isready -h postgres_host -p 5432 -U username; do sleep 1; done && alembic upgrade head"
     

4. 检查表名大小写与Schema匹配

   • 确认PostgreSQL中表名的实际大小写，以及Alembic是否指定了正确的Schema（默认是public）。如果表是用带引号的名称创建的（如"Products"），则Product.__tablename__必须完全匹配这个大小写。

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