Django 1.11中使用.exclude或~Q()标注子查询失效问题

错误原因 #

你遇到的ValueError核心问题是：Subquery要求子查询必须返回单行单列的结果，但你的子查询通过values('code')分组后生成了多行数据，再加上OuterRef对外部查询的引用，导致Django无法正确解析子查询的结构，从而触发该错误。

解决方案 #

根据你的实际需求选择对应的修正方式：

需求1：统计所有排除匹配hash的Foo记录总数 #

如果只是想统计code__hash不等于外层模型hash字段的所有Foo记录数量，直接移除分组逻辑，确保子查询返回单个值：

def get_queryset(self):
    return self.queryset.annotate(
        foo_count=Subquery(
            Foo.objects.exclude(code__hash=OuterRef('hash'))
            .values_list(Count('pk'), flat=True)[:1],
            output_field=IntegerField()
        ),
    )

需求2：统计与外层对象关联的code的匹配计数 #

如果需要针对外层对象的特定code（假设外层模型有code字段），统计排除匹配hash后的该code对应Foo数量：

def get_queryset(self):
    return self.queryset.annotate(
        foo_count=Subquery(
            Foo.objects.filter(code=F('code'))
            .exclude(code__hash=OuterRef('hash'))
            .annotate(cnt=Count('pk'))
            .values('cnt'),
            output_field=IntegerField()
        ),
    )

替代方案：使用FilteredRelation（适用于有外键关联的场景） #

如果外层模型和Foo存在外键关联，可以用FilteredRelation更简洁地实现：

from django.db.models import Count, FilteredRelation, Q

def get_queryset(self):
    return self.queryset.annotate(
        filtered_foo=FilteredRelation(
            'foo_set',  # 替换为外层模型与Foo关联的反向关系名
            condition=~Q(foo_set__code__hash=F('hash'))
        ),
        foo_count=Count('filtered_foo')
    )

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