Alembic自动生成迁移时跨schema外键重复删除重建问题

该问题由跨Schema外键的元数据匹配偏差导致：

1. 当外键所属表配置了非默认Schema（示例中为foo）时，SQLAlchemy不会自动为未显式标注Schema的被引用表填充MSSQL默认的dbo Schema，代码侧解析出的被引用表Schema值为None
2. MSSQL系统表中存储的外键元数据会显式标记被引用表属于dbo Schema
3. Alembic的autogenerate逻辑逐字段对比外键属性时，会因为Schema字段None与dbo不相等，误判现有外键和代码定义不一致，最终生成多余的外键删除、重建语句

另外你贴出的Table2定义中__table_args__存在语法错误：ForeignKeyConstraint声明末尾缺少逗号分隔，会导致后续的Schema配置字典无法被正确解析，需要先修正该问题。

按实现成本和稳定性排序，可选择以下任意一种方案修复：

• 外键定义显式写全被引用表的Schema路径
  这是最直接、无额外依赖的修复方式，修改Table2的外键配置，将被引用列写为[Schema名].[表名].[列名]的完整格式即可。示例中Table1属于默认dbo Schema，修正后的代码如下：

  class Table2(Base):
      __tablename__ = "table2"
      __table_args__ = (
          # 补全约束后缺失的逗号，被引用列显式添加dbo.前缀
          ForeignKeyConstraint(['Table1ID'], ['dbo.Table1.ID'], name='fk_Table2_Table1'),
          {'schema': 'foo'}
      )
  
      Table1ID = Column(Integer, nullable=False)
      Table1_ = relationship('Table1', back_populates='Table2')
  

  修改后重新执行alembic revision --autogenerate，代码侧解析出的被引用表Schema会和数据库侧一致，不会再生成冗余的外键删建语句。

• 全局自定义Alembic外键对比规则
  如果项目中跨Schema外键较多，不想逐个修改模型定义，可以在Alembic的env.py中自定义比较逻辑，让对比过程将默认Schema下的None值与dbo判定为等价：

  1. 在env.py中导入默认外键比较方法：

     from alembic.autogenerate.compare import _fk_compare
     

  2. 编写自定义比较函数，统一标准化外键的默认Schema值：

     def compare_foreign_keys(fk_a, fk_b):
         def normalize_target_schema(fk):
             if fk.target_schema is None:
                 fk.target_schema = "dbo"
             return fk
         return _fk_compare(normalize_target_schema(fk_a), normalize_target_schema(fk_b))
     

  3. 在context.configure配置项中挂载自定义比较函数，其余原有配置保持不变：

     context.configure(
         connection=connection,
         target_metadata=target_metadata,
         compare_foreign_keys=compare_foreign_keys,
         # 其他原有配置项...
     )
     

  该方案全局生效，不需要修改现有ORM模型定义，适合中大型项目使用。

• 为默认Schema下的表显式声明Schema属性
  给所有存储在dbo默认Schema下的ORM模型（比如示例中的Table1），也在__table_args__中显式添加{"schema": "dbo"}配置，SQLAlchemy解析外键引用时会自动读取被引用表的Schema属性，和数据库侧元数据匹配。该方案的缺点是和MSSQL的默认Schema强绑定，后续如果需要迁移数据库或调整默认Schema，改动成本较高，不推荐优先使用。

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