Alembic多分支迁移依赖执行顺序不符预期，如何调整？

核心原因 #

Alembic基于依赖关系的拓扑排序确定迁移顺序，当前C是B的直接后继，B'仅依赖B但未与C建立顺序约束，因此Alembic会优先执行完main分支的A→B→C路径，再处理dev分支的B'→C'。

可行解决方案 #

方案1：修改C的依赖（dev分支专属） #

在dev分支中，给C的迁移文件添加对B'的依赖，强制Alembic先执行B'再执行C：

1. 找到C对应的迁移文件（如xxxx_c.py）。
2. 修改文件头部的depends_on字段，加入B'的修订ID：

   revision = 'xxxx_c'
   down_revision = 'xxxx_b'
   depends_on = ['xxxx_b_']  # 替换为B'的实际修订ID
   

3. 执行alembic upgrade dev@head，此时顺序会变为A→B→B'→C→C'。

注意：此修改仅保留在dev分支，绝对不要合并到main分支，否则会破坏main分支的迁移独立性。

方案2：手动拆分升级命令 #

如果不想修改迁移文件，可分四步手动控制顺序：

• 升级到B：alembic upgrade B
• 升级到B'：alembic upgrade B'
• 升级到C：alembic upgrade C
• 升级到C'：alembic upgrade C'

方案3：创建空桥接迁移（无侵入式） #

在dev分支中创建一个空操作的桥接迁移，用来构建B'→C的依赖链：

1. 生成桥接迁移：

   alembic revision --branch-point B --depends-on B' --message "Bridge to enforce B' before C"
   

2. 打开生成的迁移文件，将down_revision设为B，并确保upgrade()和downgrade()函数为空（无任何数据库操作）。
3. 修改C的迁移文件，将down_revision改为桥接迁移的修订ID（仅在dev分支中修改）。
4. 执行alembic upgrade dev@head，迁移顺序会变为A→B→B'→[桥接迁移]→C→C'，满足预期。

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