如何将带through参数的M2M字段转换为Django原生托管的M2M字段

前置检查：原有StudentCourse模型需已设置student和course的联合唯一约束。如果没有，先给StudentCourse模型添加unique_together = [["student", "course"]]，执行一次makemigrations和migrate，保证中间表数据符合原生M2M的约束要求，再进行后续操作。

操作步骤 #

• 第一步：调整模型定义，指定原生M2M字段复用原有中间表
  直接修改模型代码如下，替换其中你的APP名称为对应Django应用的名称：

  class Student(models.Model):
      # ... 其他原有字段
      # 可根据需求保留原字段名courses或修改为course，此处以你期望的course为例
      course = models.ManyToManyField(
          Course,
          related_name='students',
          # 指定数据库表为原有through中间表的表名，默认规则为「APP名_小写中间表类名」
          db_table="你的APP名称_studentcourse"
      )
  
  class Course(models.Model):
      # ... 其他原有字段
  

  直接删除或注释掉原有的StudentCourse模型定义。

• 第二步：生成迁移文件并调整操作逻辑
  执行python manage.py makemigrations生成初始迁移文件，打开新生成的迁移文件，将自动生成的operations列表全部替换为以下内容（保留原有dependencies依赖配置不要修改）：

  from django.db import migrations, models
  
  class Migration(migrations.Migration):
      dependencies = [
          # 此处保留自动生成的依赖配置，不要修改
      ]
  
      operations = [
          migrations.SeparateDatabaseAndState(
              # 仅修改Django层面的模型元数据，不执行任何数据库操作
              state_operations=[
                  # 移除原来带through参数的M2M字段
                  migrations.RemoveField(
                      model_name='student',
                      name='courses',
                  ),
                  # 从模型元数据中删除原有中间表模型
                  migrations.DeleteModel(
                      name='StudentCourse',
                  ),
                  # 新增无through的原生M2M字段
                  migrations.AddField(
                      model_name='student',
                      name='course', # 如果保留原字段名此处改为courses
                      field=models.ManyToManyField(
                          related_name='students', 
                          to='你的APP名称.Course', 
                          db_table='你的APP名称_studentcourse'
                      ),
                  ),
              ],
              database_operations=[
                  # 数据库层面不做任何操作，复用原有表和数据
              ]
          )
      ]
  

• 第三步：执行迁移
  直接运行python manage.py migrate即可，该操作仅更新Django的迁移元数据记录，不会修改数据库中的表结构和已有数据，操作完成后即可正常使用原生M2M字段的所有API。

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