如何为Django项目第三方应用配置一致迁移规则避免迁移命令报错

django.db.migrations.exceptions.NodeNotFoundError: Migration users.0001_initial dependencies reference nonexistent parent node ('auth', '0011_update_proxy_permissions')

报错根因 #

自定义users应用的0001号初始迁移文件，依赖了Django内置auth应用的0011号迁移，但当前环境运行的Django版本自带的auth应用最高迁移版本低于0011，无法找到对应父节点。 #

修复步骤 #

• 第一步：查询当前环境auth应用的有效迁移版本
  执行命令查看auth应用的所有迁移，记录最高的已存在迁移编号：
  python manage.py showmigrations auth
  例如Django 3.1版本auth的最高迁移为0011_update_proxy_permissions，Django 3.0及以下版本最高为0010_alter_group_name_max_length。
• 第二步：修改users应用迁移的依赖配置
  打开项目中users/migrations/0001_initial.py文件，找到dependencies配置项，将其中的('auth', '0011_update_proxy_permissions')修改为第一步查询到的实际存在的auth最高迁移版本，版本号与迁移名需完全匹配。
• 第三步：对齐迁移与数据库状态
  • 如果数据库中已经存在users应用对应的表结构，无需修改表结构的情况下，执行命令标记该迁移已执行：
    python manage.py migrate --fake users 0001_initial
  • 如果是全新未初始化的数据库，直接执行正常迁移命令即可：
    python manage.py migrate

长期避免该问题的配置方案 #

• 所有开发、部署环境统一依赖版本，在项目根目录维护requirements.txt、poetry.lock等版本锁定文件，所有环境安装依赖时均从锁定文件安装，避免不同环境的Django版本不一致导致内置应用迁移版本不匹配。
• 跨Django版本升级后，先执行python manage.py migrate完成内置应用迁移升级，再生成自定义应用的新迁移文件。
• 仅提交项目自定义应用的迁移文件到版本仓库，忽略第三方依赖、内置应用的迁移文件，避免拉取到其他环境生成的不兼容迁移。

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