如何在Django Admin自定义过滤器中使用模型自定义方法？

问题根源是Django ORM无法识别模型的自定义方法（比如get_average_rating）作为数据库查询字段——这类方法是在Python层面计算的，并非数据库中实际存在的字段。要解决这个问题，需要把平均评分的计算逻辑移到数据库层面，通过annotate生成注解字段后再进行过滤。

具体实现步骤 #

1. 在过滤器中通过annotate计算平均评分
   利用Django的F()表达式直接引用模型的评分字段，在数据库层面计算平均值，生成临时注解字段（比如average_rating）。假设你的6个评分字段是score1到score6，代码示例如下：

   from django.contrib import admin
   from django.db.models import F, FloatField, ExpressionWrapper
   from django.utils.translation import gettext_lazy as _
   
   class RoomScoreFilter(admin.SimpleListFilter):
       title = _('Room Score')
       parameter_name = 'room_score'
   
       def lookups(self, request, model_admin):
           return (
               ('very_poor', _('Very poor (1.00-1.99)')),
               ('poor', _('Poor (2.00-2.99)')),
               ('average', _('Average (3.00-3.99)')),
               ('good', _('Good (4.00-4.99)')),
               ('excellent', _('Excellent (5.00)')),
           )
   
       def queryset(self, request, queryset):
           # 计算6个评分的平均值，强制转为浮点型避免整数除法
           annotated_queryset = queryset.annotate(
               average_rating=ExpressionWrapper(
                   (F('score1') + F('score2') + F('score3') + F('score4') + F('score5') + F('score6')) / 6,
                   output_field=FloatField()
               )
           )
   
           if self.value() == 'very_poor':
               return annotated_queryset.filter(average_rating__gte=1.00, average_rating__lt=2.00)
           elif self.value() == 'poor':
               return annotated_queryset.filter(average_rating__gte=2.00, average_rating__lt=3.00)
           elif self.value() == 'average':
               return annotated_queryset.filter(average_rating__gte=3.00, average_rating__lt=4.00)
           elif self.value() == 'good':
               return annotated_queryset.filter(average_rating__gte=4.00, average_rating__lt=5.00)
           elif self.value() == 'excellent':
               return annotated_queryset.filter(average_rating=5.00)
           return annotated_queryset
   

2. 在Admin类中配置过滤器
   把自定义的RoomScoreFilter加入到list_filter列表即可：

   class ReviewAdmin(admin.ModelAdmin):
       list_filter = (RoomScoreFilter,)
       # 其他Admin配置项...
   

关键细节说明 #

• 使用ExpressionWrapper是为了确保除法结果为浮点型，避免整数评分相加后直接除以6导致的精度丢失。
• annotate将计算逻辑推送到数据库执行，比在Python层面遍历计算更高效，尤其适合数据量较大的场景。
• 如果评分字段允许为空，需要额外用Coalesce函数把空值替换为0，避免计算出错（比如Coalesce(F('score1'), 0)）。

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