如何在Django中创建关联自定义User模型的可用数据迁移？

• 全程使用迁移上下文的模型类
  迁移函数里绝对不能直接导入项目中的User或ContactPerson模型，必须通过apps.get_model()从当前迁移上下文获取所有需要的模型，包括创建实例和关联操作。示例代码：

  from django.conf import settings
  
  def create_dev_data(apps, schema_editor):
      # 拆分AUTH_USER_MODEL为app名和模型名
      user_app, user_model = settings.AUTH_USER_MODEL.split('.')
      User = apps.get_model(user_app, user_model)
      ContactPerson = apps.get_model('your_app', 'ContactPerson')
      
      # 创建实例并关联
      jim = User.objects.create(email='j.halpert@dundermifflin.com', name='Jim Halpert')
      ContactPerson.objects.create(user=jim, phone='555-1234')
  

  直接导入的模型类和迁移上下文里的模型属于不同的类对象，哪怕结构一致也会触发类型不匹配错误。

• 严格控制迁移依赖顺序
  确保数据迁移的dependencies列表包含自定义User模型所在app的最后一个迁移，以及ContactPerson模型的迁移。比如：

  dependencies = [
      ('accounts', '0001_initial'),  # 假设自定义User在accounts app的0001迁移里
      ('contacts', '0002_contactperson'),  # ContactPerson模型的迁移
  ]
  

  依赖顺序错误会导致关联字段的模型上下文未完全初始化，引发实例类型问题。

• 清理迁移缓存与残留
  如果之前执行过错误的迁移，可能留下缓存导致模型上下文混乱：

  1. 删除目标app的migrations目录下除__init__.py外的所有文件
  2. 重新生成初始迁移：python manage.py makemigrations
  3. 重新执行迁移：python manage.py migrate

• 验证模型类一致性
  在迁移函数中添加调试代码，确认关联字段的模型与获取的User模型是同一个：

  def create_dev_data(apps, schema_editor):
      user_app, user_model = settings.AUTH_USER_MODEL.split('.')
      User = apps.get_model(user_app, user_model)
      ContactPerson = apps.get_model('your_app', 'ContactPerson')
      
      # 打印对比模型类
      print("ContactPerson.user关联模型:", ContactPerson.user.field.related_model)
      print("获取的User模型:", User)
  

  若两者输出不一致，说明依赖或模型获取方式有误，需要调整。

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