django-filter搭配DRF ModelViewSet不同字段筛选行为不一致问题

最核心的几个原因按出现概率从高到低排列：

• DjangoFilterBackend 导入来源错误
  DRF 自带的 rest_framework.filters.DjangoFilterBackend 已经在 3.7 版本后正式弃用，该旧版本后端仅识别 filter_fields 配置，不识别新版 django-filter 库推出的 filterset_fields 参数。如果 TeacherViewSet 过滤逻辑正常，大概率是两个 ViewSet 导入的 DjangoFilterBackend 来源不一致，或者 TeacherViewSet 实际配置的是 filter_fields 而非你贴出的 filterset_fields。
  你可以检查导入语句：
  错误导入写法：

  from rest_framework.filters import DjangoFilterBackend
  

  正确导入写法：

  from django_filters.rest_framework import DjangoFilterBackend
  

  临时验证方案：你可以把 SchoolViewSet 中的 filterset_fields 改成 filter_fields，如果请求 /school/?udise=111 生效，即可确认是导入来源错误问题。
• 参数类型不匹配
  udise 是模型定义的 IntegerField 字段，如果请求参数 udise 的值包含非数字字符（比如空格、特殊符号），DjangoFilterBackend 会默认忽略非法的过滤条件，直接返回全量数据。你可以打印 request.query_params 确认参数值是否符合数值格式要求。
• 全局配置覆盖
  如果你在 settings.py 中配置了 DEFAULT_FILTER_BACKENDS 全局过滤后端，且其中没有包含 DjangoFilterBackend，同时 ViewSet 中配置的 filter_backends 存在拼写错误、导入错误，也会导致过滤逻辑不执行。

1. 确认已安装 django-filter 依赖
2. 统一使用 from django_filters.rest_framework import DjangoFilterBackend 导入过滤后端
3. 保持 filterset_fields = ['udise', ] 配置即可和 TeacherViewSet 筛选逻辑完全一致

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