Django makemigrations模型创建顺序异常原因及期望场景咨询

一、你期望的迁移顺序出现的场景 #

当满足以下条件时，makemigrations会生成你期望的“先创建MedicalTestGroup，再创建MedicalTest”的顺序：

• 同一app内，MedicalTestGroup的代码定义在MedicalTest之前，且MedicalTest中直接包含指向MedicalTestGroup的外键字段。
• 跨app场景下，MedicalTestGroup所在的app在INSTALLED_APPS中的排序，早于MedicalTest所在的app。
• 模型间无循环依赖，且外键引用能被Django在首次扫描时直接解析（未使用延迟字符串引用，或使用了但无依赖冲突）。

二、为何会出现拆分式的迁移顺序？ #

1. 模型定义顺序与依赖关系冲突 #

如果MedicalTest的代码写在MedicalTestGroup之前，Django首次扫描模型时，先识别到MedicalTest但无法解析未加载的MedicalTestGroup，只能先创建不含外键的MedicalTest，等加载完MedicalTestGroup后，再补充外键字段和唯一约束。

2. 增量修改模型 #

如果先创建了MedicalTest模型并生成了迁移，之后才添加指向MedicalTestGroup的外键，makemigrations会基于现有迁移的增量变化，生成“添加字段”的后续迁移，而非重新调整初始创建顺序。

3. 循环依赖或延迟引用问题 #

若两个模型存在互相引用的循环依赖，或使用字符串形式的延迟引用（如models.ForeignKey('MedicalTestGroup', ...)），Django可能无法在首次创建时完整解析依赖链，只能拆分操作以避免迁移失败。

三、Django处理迁移顺序的核心逻辑 #

Django迁移系统的排序逻辑围绕模型依赖关系和加载顺序展开：

• 优先按INSTALLED_APPS中的app顺序处理，靠前的app先生成迁移。
• 同一app内，按模型在models.py中的定义顺序扫描。
• 若扫描时遇到未加载的依赖模型，Django会先创建当前可解析的模型，后续再补充关联字段或约束，确保迁移过程不会因依赖未就绪而报错。

四、优化代码的建议 #

• 按依赖顺序组织模型：在models.py中先定义被依赖的模型（如MedicalTestGroup），再定义依赖它的模型（MedicalTest）。
• 初始定义时补全关联：首次创建模型就把外键、唯一约束等关联逻辑写完整，避免后续增量修改导致拆分迁移。
• 清理循环依赖：检查模型间的引用关系，尽量保持单向依赖，必要时用related_name合理配置反向关联，避免循环。
• 调整跨app顺序：若依赖其他app的模型，将依赖方app放在INSTALLED_APPS的前面。

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