Django ManyToMany with through 自定义中间表实战指南

Ryan

发布时间：2026-10-15| 4人浏览过

原创

本文深入解析Django中ManyToMany字段通过through参数自定义中间表的实现方法。通过Group与Person模型的示例，展示如何创建包含额外字段（如加入时间、邀请原因）的中间模型，并详细讲解视图集与序列化器的配置，特别是如何在Group序列化器中正确获取和展示关联的中间表数据。

多对多中间表详解

在Django框架中，处理ManyToMany（多对多）关系时，系统默认会生成一张第三张中间表来维护两个模型之间的关联。本文将通过具体案例，详细阐述如何利用这张中间表进行数据关联与管理。

默认中间表

class Person(models.Model):
    name = models.CharField(max_length=128)
    def __str__(self):
        return self.name
class Group(models.Model):
    name = models.CharField(max_length=128)
    members = models.ManyToManyField(Person)
    def __str__(self):
        return self.name

以Group模型为例，通过定义members字段并指定ManyToMany关系，即可与Person模型建立多对多关联。

接下来，我们观察默认生成的中间表结构：

该表包含一个自增的id字段，这是Django自动添加的主键。此外，还包含指向Group和Person的外键id列，用于建立两表间的映射关系。若需指定关联的具体字段，可通过to_field参数进行配置。

由此可见，默认中间表并不存储两张主表的完整数据，而是仅通过id字段进行关联映射，从而节省存储空间并维护数据一致性。

通过through自定义中间表

通常情况下，默认的中间表已能满足大多数多对多关系的需求。但在复杂场景下，例如需要记录成员加入分组的具体时间或进组原因时，就需要自定义中间表。

Django提供了through参数，允许用户指定一个自定义的中间模型。该模型可以包含除关联主表外的其他字段，如时间戳、状态或备注信息等。具体实现示例如下：

模型定义：

from django.db import models
class Person(models.Model):
    name = models.CharField(max_length=128)
    def __str__(self):
        return self.name
class Group(models.Model):
    name = models.CharField(max_length=128)
    members = models.ManyToManyField(Person, through='Membership')
    def __str__(self):
        return self.name
class Membership(models.Model):
    person = models.ForeignKey(Person, on_delete=models.CASCADE)
    group = models.ForeignKey(Group, on_delete=models.CASCADE)
    date_joined = models.DateField()  # 进组时间
    invite_reason = models.CharField(max_length=64)  # 邀请原因

视图层代码：

class PersonViews(ModelViewSet):
    queryset = Person.objects.filter()
    serializer_class = PersonSerializers
class GroupViews(ModelViewSet):
    queryset = Group.objects.filter()
    serializer_class = GroupSerializers
class MembershipViews(ModelViewSet):
    queryset = Membership.objects.filter()
    serializer_class = MembershipSerializers

序列化器配置：

from .models import Person, Group, Membership
class MembershipSerializers(serializers.ModelSerializer):
    class Meta:
        model = Membership
        fields = '__all__'
class PersonSerializers(serializers.ModelSerializer):
    class Meta:
        model = Person
        fields = '__all__'
class GroupSerializers(serializers.ModelSerializer):
    def to_representation(self, instance):
        representation = super(GroupSerializers, self).to_representation(instance)
        representation['members'] = []
        for i in PersonSerializers(instance.members, many=True).data:
            reason = MembershipSerializers(instance.membership_set.get(group=instance.id, person=i['id'])).data['invite_reason']
            i['invite_reason'] = reason
            representation['members'].append(i)
        return representation
    class Meta:
        model = Group
        fields = '__all__'

从Membership模型的角度来看，它实际上建立了与Group和Person两个模型的多对一关系。Django在启动时，会自动在关联的主模型上生成“[model]_set”属性，这与常规的多对一关系处理方式一致——尽管Person在此处扮演了不同的角色，但底层逻辑仍是多对一关系。

reason = MembershipSerializers(instance.membership_set.get(group=instance.id, person=i[‘id’])).data[‘invite_reason’]

上述代码通过group和person的联合查询，从Membership中获取对应的邀请原因。

在person和group模型上，membership对象的默认访问属性均为membership_set。因此，通过instance.membership_set.get()方法，可以查询特定group下的所有关联关系。

查看person下的所有membership记录：

    # def to_representation(self, instance):
    #     representation = super(PersonSerializers, self).to_representation(instance)
    #     representation['reason'] = MembershipSerializers(instance.membership_set, many=True).data
    #     return representation