Alembic自动生成迁移重复创建已存在表的问题及解决

我刚好碰到过一模一样的情况！问题核心在于Alembic默认不会自动识别你指定的basic schema，第二次执行autogenerate时，它找不到已存在的basic.user表，就会重复生成创建语句。不想用include_schemas=True把所有schema都纳入的话，试试这两种精准控制的方法：

方法一：用include_name过滤指定Schema #

在你的env.py里，修改context.configure()的配置，开启include_schemas=True的同时，用自定义函数只允许basic schema通过：

from alembic import context

def include_name(name, type_, parent_names):
    if type_ == "schema":
        # 仅保留basic schema
        return name == "basic"
    return True

def run_migrations_online():
    # ... 保留你原有的数据库连接、target_metadata等配置 ...
    context.configure(
        connection=connection,
        target_metadata=target_metadata,
        include_schemas=True,
        include_name=include_name,  # 加入这个过滤规则
        # ... 其他原有配置（比如compare_type=True等） ...
    )

这样Alembic会扫描数据库中的所有schema，但只会处理basic下的对象，就能正确识别已存在的basic.user表，仅生成新增country表的迁移代码。

方法二：给模型类明确指定Schema #

还要确保你的models.py里的所有模型都绑定到basic schema，避免Alembic混淆表的归属：

from sqlalchemy import Column, Integer, String
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class User(Base):
    __tablename__ = 'user'
    __table_args__ = {'schema': 'basic'}  # 绑定到basic schema
    id = Column(Integer, primary_key=True)
    # ... 其他字段定义 ...

class Country(Base):
    __tablename__ = 'country'
    __table_args__ = {'schema': 'basic'}  # 新增模型同样绑定
    id = Column(Integer, primary_key=True)
    # ... 其他字段定义 ...

让Base.metadata里的表都明确归属basic schema，Alembic在对比数据库状态时就能精准匹配，不会误判user表不存在。

验证操作步骤 #

1. 删除之前错误生成的、包含重复创建user表的迁移文件
2. 重新执行alembic revision --autogenerate -m"Create country model"，此时生成的迁移文件只会包含创建country表的代码
3. 运行alembic upgrade heads，就能成功创建country表，不会再出现表已存在的报错

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