Django跨应用迁移模型时报ValueError：字段lazy reference对应模型不存在

数据老陈

2026-10-23

问题核心成因

现有迁移逻辑的适配性偏差：你编写的两个迁移是为了适配已有存量数据库的升级流程设计的，但本地全新空库的初始化流程，会严格按迁移文件的执行顺序逐段构建全量模型状态，提前做状态完整性校验，不会像老库那样跳过状态预检查直接执行SQL。
迁移操作的顺序逻辑错误：你之前把“修改关联模型外键指向”和“删除旧应用Foo模型”的动作顺序做反了，且手动枚举的外键关联列表不全，漏掉了抽象基类上定义的外键、子类继承获得的关联字段等未被显式定义的关联，导致状态构建时，外键引用的旧Foo模型已经被标记删除，却还有其他字段持有对它的有效引用，直接触发校验报错。
状态同步的覆盖缺口：Django的迁移状态校验是在执行所有数据库操作前完成的，只要某一步状态构建时发现存在字段引用不存在的模型，就会直接抛出ValueError，不会等待你后续的改表操作执行——这也是公司老库能跑通的原因：老库执行迁移时是逐阶段同步状态和SQL，且很多场景下会直接基于现有models.py的定义生成状态，绕过了空库初始化时的全量状态预校验。

可落地修复步骤

重构迁移操作的执行顺序，严格遵循依赖逻辑：
- 第一步在新应用下完成Foo模型的创建，确保状态层面新Foo模型已经注册完成
- 第二步全量更新所有关联模型的外键指向，把状态层面所有指向旧应用Foo的外键，统一改为指向新应用的Foo
- 第三步最后再执行状态层面的旧应用Foo模型删除操作，绝对不能把删旧模型的动作放在改外键的前面

放弃手动枚举关联模型的AlterField操作，避免漏改：
手动罗列所有需要改外键的模型一定会漏（比如你错误栈里提到的AbstractCreative类的外键，就是抽象基类定义的关联，会被同步到所有继承它的子类上，手动枚举很容易漏掉）。正确的做法是在迁移文件里结合SeparateDatabaseAndState动态生成操作，核心逻辑参考如下：

from django.db.migrations.operations import SeparateDatabaseAndState, AlterField, DeleteModel
from django.db import models

# 动态遍历所有关联旧Foo的模型生成外键调整操作
def sync_foreign_key_state(apps, schema_editor):
    old_foo = apps.get_model("old_app", "Foo")
    new_foo = apps.get_model("new_app", "Foo")
    # 遍历全量模型，匹配持有旧Foo外键的字段
    for model in apps.get_models():
        for field in model._meta.get_fields():
            remote_field = getattr(field, "remote_field", None)
            if remote_field and remote_field.model == old_foo:
                remote_field.model = new_foo

分离数据库操作和状态操作：
如果新旧Foo本质对应同一张物理数据库表，不需要真的修改表结构，就通过SeparateDatabaseAndState把“仅更新状态的外键指向”和“实际修改数据库外键约束”两个动作拆分，避免不必要的表结构变更。
迁移完整性校验：
编写完成迁移后，先执行python manage.py makemigrations --dry-run，检查是否存在未覆盖的状态同步操作；再用空数据库测试全量迁移流程，确认能从空状态完整构建到最终的模型状态，没有引用缺失的报错。

常见踩坑提醒：抽象基类上定义的外键会被自动同步到所有继承它的子类模型上，手动编写迁移时很容易只修改直接定义的抽象类，漏掉子类上继承生成的外键状态，最终触发“lazy reference 指向不存在模型”的报错。

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