自定义Tenant模型设app_label='auth'时makemigrations报NodeNotFound错误
app_label="auth"触发的迁移依赖报错问题 问题场景
项目中自定义了带UUID主键的Tenant模型,通过Meta配置将模型归属到auth应用标签下:
class Tenant(models.Model): id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False) name = models.TextField(unique=True) class Meta: app_label = "auth"
在全新虚拟环境执行makemigrations命令、或是运行pytest测试时,固定抛出如下迁移解析错误:
django.db.migrations.exceptions.NodeNotFoundError: Migration nqm_core.0001_initial dependencies reference nonexistent parent node ('auth', '0013_tenant')
已验证的无效排障操作
以下操作均无法解决报错,仅当移除Tenant模型Meta配置中的app_label = "auth"配置项时,问题才会消失;若直接删除nqm_core初始迁移文件中的对应依赖配置,数据库迁移流程会直接中断:
- 删除所有迁移文件后重新执行迁移流程
- 将所有迁移fake到零状态后重新执行迁移
- 新建空数据库后重新执行迁移操作
- 升级Django版本后重新执行迁移
- 新建独立虚拟环境后重新执行迁移
问题根因
这个报错不是Django的未知Bug,核心是对跨标签挂载自定义模型的迁移生成逻辑理解有偏差:
当你给Tenant模型设置app_label = "auth"时,Django会把这个模型对应的所有迁移归到内置django.contrib.auth的迁移序列里,但直接跑全量makemigrations的时候,Django的迁移文件生成顺序是没有固定保证的:
- 如果先生成nqm_core的迁移文件,检测到它和Tenant的关联依赖,会自动在依赖列表里写入
("auth", "<自增的迁移编号>") - 但内置auth应用的迁移目录默认在第三方包的只读路径下,Tenant对应的建表迁移文件不会被正确写到auth的迁移目录里,最终就会出现“其他应用引用了auth下根本不存在的迁移节点”的报错
- 之前手动删除nqm_core迁移里的依赖之所以会让迁移中断,是因为nqm_core里关联Tenant的外键字段会因为时序错乱,在Tenant表还没建出来的时候就尝试创建外键约束,数据库直接报错。
这类跨应用标签挂载场景的标准操作流程
如果确实有需求要把自定义模型挂到auth标签下,不能直接用默认的全量迁移生成逻辑,要按固定顺序操作:
- 第一步先单独生成Tenant对应的专属迁移,执行命令:
./manage.py makemigrations auth --name tenant
这一步会强制把Tenant的建表迁移文件写到auth应用的迁移目录里,和auth原有的迁移序列按顺序拼接,不会乱序 - 等这个迁移文件生成完成后,再跑全量的
./manage.py makemigrations,这时候其他应用生成的迁移文件会自动引用刚生成的auth迁移节点,不会凭空生成不存在的依赖编号 - 最后按常规流程跑
./manage.py migrate就能完成全量表结构创建
注意:非必要不建议把自定义模型直接挂载到内置应用的标签下,这种操作会导致后续Django升级内置auth功能时,出现迁移序列冲突,排查成本很高。
内容的提问来源于stack exchange,提问作者Vaibhav

