Django多对多中间表查询疑问：Group为何无法直接关联Person查询？

问题描述 #

在使用Django多对多中间模型时，遇到以下查询行为差异：

• 针对Person模型，关联Group并查询中间模型属性的语句可正常运行：

Person.objects.filter(
    group__name='The Beatles',
    membership__date_joined__gt=date(1961,1,1))

• 但对Group模型尝试直接查询关联Person时，会触发FieldError：

# 触发FieldError的错误查询
Group.objects.filter(person__name__contains="Paul")

• 显式引用中间模型Membership的跨表查询则能正常执行：

Person.objects.filter(membership__group__name__contains="The Beatles")
Group.objects.filter(membership__person__name__contains="Paul")

对应的模型定义：

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)

原因分析 #

核心问题在于Django多对多关联的字段命名规则：

1. 对于Person模型：由于Group定义了指向它的多对多字段members，Django会自动为Person创建反向关联group_set，同时允许用模型名小写group作为查询别名，因此Person.objects.filter(group__name=...)可以正常工作。
2. 对于Group模型：它的多对多字段是members，查询关联的Person必须使用这个字段名作为查询前缀，即members__name__contains="Paul"。而你使用的person__是中间模型Membership中的外键字段名，并非Group模型的直接关联字段，Django无法识别该字段，因此触发FieldError。

正确查询方式 #

如果不想显式引用中间模型，Group的正确查询写法为：

Group.objects.filter(members__name__contains="Paul")

而membership__person__name__contains="Paul"能正常运行，是因为它显式通过中间模型Membership的person外键关联到Person模型，属于合法的跨表查询逻辑。

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