Flask-Migrate指定数据库Schema迁移报错：重复建表问题排查

问题原因 #

Flask-Migrate依赖的Alembic默认仅检测数据库的默认schema，当模型放在自定义schema（schema_tg_bot）中时，第二次执行迁移时，Alembic无法识别该schema下已存在的表，进而重复生成建表语句，触发表已存在的报错。

解决方案 #

1. 配置SQLAlchemy加载指定Schema #

在Flask配置中添加SQLALCHEMY_SCHEMAS参数，让SQLAlchemy能识别自定义schema：

# 可在环境配置类中添加
class Config:
    # 其他配置项...
    SQLALCHEMY_SCHEMAS = "schema_tg_bot"

# 或直接在app初始化时设置
app.config['SQLALCHEMY_SCHEMAS'] = 'schema_tg_bot'

2. 修改Alembic的env.py文件 #

找到项目根目录下的migrations/env.py，修改run_migrations_online函数，让Alembic支持检测自定义schema的表：

def run_migrations_online():
    # ... 保留原有代码 ...
    with connectable.connect() as connection:
        context.configure(
            connection=connection,
            target_metadata=target_metadata,
            # 开启多schema检测
            include_schemas=True,
            # 可选：将迁移版本表也放在自定义schema中
            # version_table_schema='schema_tg_bot'
        )

        with context.begin_transaction():
            context.run_migrations()

3. 重新生成正确的迁移文件 #

删除之前生成的错误迁移文件，重新执行迁移生成命令：

flask db migrate -m "add type field to bot"

此时生成的迁移文件只会包含添加type字段的语句，而非重复建表。

4. 执行迁移升级 #

最后正常执行升级操作：

flask db upgrade

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