Django Admin中对注解字段使用list_filter与ordering时触发FieldDoesNotExist错误的解决咨询

你遇到的问题很典型：Django Admin的list_filter默认只认模型实际定义的数据库字段，而event_start_date是你通过annotate动态添加的聚合字段，并非Event模型本身的字段，所以Django在尝试查找这个字段时就抛出了FieldDoesNotExist错误。

而且你提到的用eventsession_set__start_date直接筛选会导致一条Event对应多条记录，这是因为Django会关联EventSession表进行筛选，产生笛卡尔积，而我们需要的是基于聚合后的值（每个Event的最早/最晚会话时间）来筛选，同时保持每条Event只显示一次。

下面是针对Django 3.2版本的具体解决思路和代码实现：

1. 自定义过滤器类 #

我们需要继承Django Admin的SimpleListFilter（或者针对日期范围的DateRangeFilter），自己实现筛选逻辑，这样就能基于聚合后的注解字段来过滤数据。

示例1：自定义基础筛选器（支持固定选项） #

from django.contrib.admin import SimpleListFilter
from django.db.models import Min, Max
from django.utils import timezone

class EventStartDateFilter(SimpleListFilter):
    # 过滤器在Admin页面显示的标题
    title = '活动开始日期'
    # URL中使用的参数名，比如?event_start_date=upcoming
    parameter_name = 'event_start_date'

    def lookups(self, request, model_admin):
        # 返回筛选选项（显示文字和对应参数值）
        return (
            ('upcoming', '即将开始'),
            ('past', '已结束'),
        )

    def queryset(self, request, queryset):
        # 根据选中的参数值，对查询集应用聚合筛选
        selected_value = self.value()
        if not selected_value:
            return queryset

        # 先对查询集添加注解，再基于注解字段筛选
        annotated_qs = queryset.annotate(event_start_date=Min('eventsession_set__start_date'))
        if selected_value == 'upcoming':
            return annotated_qs.filter(event_start_date__gte=timezone.now())
        elif selected_value == 'past':
            return annotated_qs.filter(event_start_date__lt=timezone.now())
        return queryset

# 同理可以定义EventEndDateFilter
class EventEndDateFilter(SimpleListFilter):
    title = '活动结束日期'
    parameter_name = 'event_end_date'

    def lookups(self, request, model_admin):
        return (
            ('ongoing', '进行中'),
            ('completed', '已完成'),
        )

    def queryset(self, request, queryset):
        selected_value = self.value()
        if not selected_value:
            return queryset

        annotated_qs = queryset.annotate(event_end_date=Max('eventsession_set__start_date'))
        if selected_value == 'ongoing':
            return annotated_qs.filter(event_end_date__gte=timezone.now())
        elif selected_value == 'completed':
            return annotated_qs.filter(event_end_date__lt=timezone.now())
        return queryset

示例2：自定义日期范围筛选器（支持用户输入日期区间） #

如果需要更灵活的日期范围筛选，可以继承Django自带的DateRangeFilter，修改其查询逻辑：

from django.contrib.admin.filters import DateRangeFilter

class AnnotatedEventStartDateRangeFilter(DateRangeFilter):
    def queryset(self, request, queryset):
        # 验证表单输入的日期范围
        if self.form.is_valid():
            cleaned_data = self.form.cleaned_data
            annotated_qs = queryset.annotate(event_start_date=Min('eventsession_set__start_date'))
            # 根据起始日期筛选
            if cleaned_data.get('start'):
                annotated_qs = annotated_qs.filter(event_start_date__gte=cleaned_data['start'])
            # 根据结束日期筛选
            if cleaned_data.get('end'):
                annotated_qs = annotated_qs.filter(event_start_date__lte=cleaned_data['end'])
            return annotated_qs
        return queryset

2. 修改Admin类，使用自定义过滤器 #

将原来list_filter中的注解字段替换为我们自定义的过滤器类：

@admin.register(Event)
class EventAdmin(admin.ModelAdmin):
    ordering = ["event_start_date"]
    # 使用自定义过滤器替换原字段
    list_filter = [EventStartDateFilter, EventEndDateFilter]
    # 可选：把注解字段添加到列表展示，方便查看
    list_display = ['name', 'event_start_date', 'event_end_date']

    def get_queryset(self, request):
        qs = super().get_queryset(request)
        qs = qs.annotate(
            event_start_date=Min("eventsession_set__start_date"),
            event_end_date=Max("eventsession_set__start_date"),
        )
        return qs

如果用日期范围筛选器，list_filter的写法要改成：

list_filter = [
    ('event_start_date', AnnotatedEventStartDateRangeFilter),
    # 同理添加event_end_date的范围筛选器
]

为什么这个方案可行？ #

• 自定义过滤器绕过了Django Admin对“模型实际字段”的校验，我们可以直接在queryset方法中对原查询集应用聚合和筛选，确保每个Event只对应一条聚合后的记录。
• 我们在过滤器中重新调用annotate（或者复用get_queryset中的注解），保证筛选逻辑是基于聚合后的单个值，避免了关联表筛选导致的重复记录问题。

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