Django FilterSet清理后无法保留多排序参数问题求助

问题原因 #

OrderingFilter 默认继承自 Django 表单字段，其默认的 clean 逻辑只会提取 QueryDict 中的最后一个值——即使请求中传入了多个 sort_by 参数，cleaned_data 里也只会保留最后一个，这和获取所有排序字段的需求不符。

解决方案：自定义支持多字段的OrderingFilter #

通过继承 OrderingFilter 并重写其 clean 方法，让它返回所有合法的排序字段列表：

from django_filters import rest_framework as filters

class MultiOrderingFilter(filters.OrderingFilter):
    def clean(self, value):
        cleaned_values = []
        # 遍历所有传入的排序参数，验证合法性后保留
        for val in value:
            # 处理带负号的降序排序（如 -creation_date）
            field_name = val.lstrip('-')
            # 检查字段是否在允许的排序字段列表中
            if field_name in self.fields:
                cleaned_values.append(val)
        return cleaned_values

在FilterSet中使用自定义过滤器 #

将原来的 OrderingFilter 替换成自定义的 MultiOrderingFilter：

class SomeFilter(filters.FilterSet):
    id = filters.BaseInFilter()
    sort_by = MultiOrderingFilter(fields=["name", "creation_date", "location"])

效果验证 #

当请求传入 ?sort_by=name&sort_by=location 时：

• filterset.form.data 仍为 QueryDict({"sort_by": ["name", "location"]})
• filterset.form.cleaned_data.get("sort_by") 会返回列表 ["name", "location"]，包含所有合法的排序字段

这样既保留了对排序字段的合法性验证，又能在 cleaned_data 中获取所有传入的排序参数。

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