Alembic初始化迁移时外键表创建顺序错误的解决办法

方案1：手动调整迁移脚本（最直接可靠） #

自动生成的迁移脚本本就需要人工校验，遇到外键顺序问题直接修改脚本即可：

• 打开alembic/versions/下刚生成的初始化迁移文件
• 将创建calibration_metric表的代码段，移动到metric表创建代码的后面
• 或者拆分表创建与外键约束：
  1. 先创建不带外键的calibration_metric表
  2. 在所有表创建完成后，单独添加外键约束：

     op.create_foreign_key(
         "fk_calibration_metric_metric_id",
         "calibration_metric",
         "metric",
         ["metric_id"],
         ["id"]
     )
     

方案2：调整模型导入顺序 #

Alembic的自动生成逻辑会参考模型的导入顺序，你可以在项目的模型入口文件（比如models/__init__.py）中，先导入被依赖的Metric模型，再导入CalibrationMetric模型：

# models/__init__.py
from .metric import Metric
from .calibration_metric import CalibrationMetric

重新生成迁移脚本，Alembic可能会自动调整表的创建顺序。不过这个方法依赖Alembic的依赖检测逻辑，不一定能覆盖所有场景。

方案3：启用批量操作模式 #

批量操作模式会通过临时表的方式绕过外键顺序限制，适合复杂结构的迁移：

1. 在alembic.ini中添加配置：

   [alembic]
   # 其他配置...
   render_as_batch = True
   

2. 重新生成迁移脚本并执行alembic upgrade head
   批量模式会先创建无约束的临时表，迁移数据后再添加外键约束，避免创建顺序问题。

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