如何移除django_filters表单select字段自带的multiple属性？

错误原因梳理 #

1. 最初的ManyToManyDescriptor相关报错，是因为你直接从Employee模型类访问多对多字段，模型类上的多对多字段是描述符对象，只有模型实例的多对多字段才是可调用all()的管理器对象，不能直接从类层面获取选项列表。
2. 后续单选框选中状态不生效，是因为你用了适配多选场景的ModelMultipleChoiceFilter，它期望接收列表类型的入参，但单选Select部件返回的是单个值，类型不匹配导致状态渲染异常，默认过滤逻辑也和单选需求不兼容。

正确实现方案 #

直接使用适配单选场景的ModelChoiceFilter，配合Select部件即可，完整代码如下：

import django_filters
from django import forms
from .models import Employee, Responsibilities
# 导入你跨模块定义的CapaType模型
from capa.models import CapaType

class EmployeeFilter(django_filters.FilterSet):
    # 职责单选筛选
    responsibilities = django_filters.ModelChoiceFilter(
        queryset=Responsibilities.objects.all(),
        widget=forms.Select(attrs={'class': 'form-control'}),
        lookup_expr='exact'
    )
    # 能力单选筛选
    abilities = django_filters.ModelChoiceFilter(
        queryset=CapaType.objects.all(),
        widget=forms.Select(attrs={'class': 'form-control'}),
        lookup_expr='exact'
    )

    class Meta:
        model = Employee
        fields = ('abilities', 'responsibilities')

逻辑说明 #

• ModelChoiceFilter本身就是为单选场景设计，和Select部件参数类型天然匹配，选中状态会自动正确渲染。
• 针对多对多字段设置lookup_expr='exact'，Django ORM会自动将查询转换为多对多字段__id__exact的逻辑，刚好满足「筛选出所有关联了选中项的员工」的需求。
• 如果有自定义筛选逻辑的需求，可以给过滤器新增method参数绑定自定义过滤函数，示例如下：

class EmployeeFilter(django_filters.FilterSet):
    def filter_responsibilities(self, queryset, name, value):
        # 可在这里自定义任意过滤逻辑，示例为默认exact效果
        return queryset.filter(responsibilities=value)

    responsibilities = django_filters.ModelChoiceFilter(
        queryset=Responsibilities.objects.all(),
        widget=forms.Select(attrs={'class': 'form-control'}),
        method='filter_responsibilities'
    )
    # 其余配置不变

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