django-filter外键字段查询时模型对象展示异常求助

看起来你遇到的核心问题是筛选器的字段配置错误，导致复选框显示的是主键而非YearLevel选项，同时筛选逻辑没有正确关联到YearLevel字段。咱们一步步来修复：

问题分析 #

你当前的YearLevelFilter里用了ModelMultipleChoiceFilter，但配置完全偏离了需求：

• 你给它传了Attendance.objects.all().distinct()作为queryset，所以复选框会渲染Attendance的主键（也就是关联的StudentNo），这就是你看到“以主键为标签的复选框”的原因。
• field_name="StudentNo"和to_field_name="BCEID"的设置完全错误，你需要筛选的是Attendance关联的StudentProfile中的YearLevel字段，正确的字段路径应该是BCEID__YearLevel。

修复方案 #

修改你的Filters.py代码，改用MultipleChoiceFilter来直接针对YearLevel字段生成复选框，同时动态获取数据库中已有的YearLevel选项：

from django import forms
import django_filters
from .models import Attendance, StudentProfile

# 动态获取数据库中所有唯一的YearLevel选项
year_level_choices = [
    (level, level) 
    for level in StudentProfile.objects.values_list('YearLevel', flat=True).distinct().order_by('YearLevel')
]

class YearLevelFilter(django_filters.FilterSet):
    yearlevel = django_filters.MultipleChoiceFilter(
        choices=year_level_choices,
        field_name="BCEID__YearLevel",  # 正确关联到StudentProfile的YearLevel字段
        widget=forms.CheckboxSelectMultiple(),
        label="Year Level",
        label_suffix="",
    )

    class Meta:
        model = Attendance
        fields = ['yearlevel']

为什么这样改？ #

1. 动态选项：通过StudentProfile.objects.values_list('YearLevel', flat=True).distinct()获取所有已存在的YearLevel值，确保复选框选项和数据库中的数据同步。
2. 正确的筛选路径：field_name="BCEID__YearLevel"告诉筛选器，要通过Attendance的BCEID关联字段，去匹配StudentProfile中的YearLevel值。
3. MultipleChoiceFilter：专门用于多选场景，默认会用IN查询来匹配选中的多个选项，完美适配复选框的需求。

额外验证点 #

• 确认StudentProfile表中的YearLevel字段有正确的值（比如"Year 8"、"Year 9"等），避免因为值为空或格式不一致导致筛选无结果。
• 如果你的YearLevel是固定的可选值（不会动态新增），也可以直接写死choices，比如：

  year_level_choices = [
      ("Year 8", "Year 8"),
      ("Year 9", "Year 9"),
      # 其他年级...
  ]
  

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