如何在Django的ManyToMany自动生成的through中间表中添加自定义字段

实现核心逻辑 #

Django自动生成的隐藏中间表不支持直接加自定义字段，你需要手动声明中间模型，指定其对应数据库表和原自动生成的表完全一致，再将原多对多字段关联到该手动声明的中间模型即可。

具体操作步骤 #

1. 声明自定义中间模型 #

在你的models.py中新增中间模型代码，注意要显式指定db_table和Django自动生成的表名完全一致，避免生成删表重建的迁移：

# 替换appname为你实际的应用名
class ModelTwoModelOneThrough(models.Model):
    model_one = models.ForeignKey(ModelOne, on_delete=models.CASCADE)
    model_two = models.ForeignKey(ModelTwo, on_delete=models.CASCADE)
    # 你要添加的自定义字段
    custom_field = models.CharField(max_length=264)

    class Meta:
        db_table = 'appname_modeltwo_modelone' # 和原自动生成的表名完全一致

2. 修改原多对多字段配置 #

修改ModelTwo中的ManyToManyField，添加through参数指向你刚声明的中间模型：

class ModelTwo(models.Model):
    # 新增through参数指定自定义中间模型
    many_field = models.ManyToManyField(ModelOne, related_name='some_name', through='ModelTwoModelOneThrough')
    field_one = models.CharField(max_length=264)

3. 生成并执行迁移 #

执行以下命令生成迁移文件：

python manage.py makemigrations

如果Django询问你是否重命名了中间表，选择是即可，此时生成的迁移只会包含新增custom_field的操作，不会删除原有表数据。
确认迁移内容无误后执行迁移：

python manage.py migrate

后续操作注意事项 #

指定自定义中间模型后，原多对多字段的add()、remove()、clear()方法默认无法直接使用，你需要通过操作中间模型实例来维护关联关系：

# 新增关联的正确写法
ModelTwoModelOneThrough.objects.create(
    model_one=your_model_one_instance,
    model_two=your_model_two_instance,
    custom_field="自定义字段值"
)

# 如果custom_field设置了默认值，也可以在add时通过through_defaults传值
your_model_two_instance.many_field.add(your_model_one_instance, through_defaults={"custom_field": "自定义字段值"})

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