Django-filter简单过滤失效：DRF车辆通行证接口过滤无效果

核心问题排查与修复 #

1. URL路径不匹配（最可能的触发原因） #

你在urls.py里注册的路由是r'permit'，但实际访问的接口是/api/v1/permits/?car_number=555（复数形式）。这意味着你当前访问的并非配置了过滤规则的PermitViewSet，自然不会触发过滤逻辑。

修复方式二选一：

• 使用正确的单数路径访问：

  http://127.0.0.1:8000/api/v1/permit/?car_number=555
  

• 或者修改路由注册为复数形式，匹配你习惯的访问路径：

  router.register(r'permits', PermitViewSet)
  

2. django-filter依赖未正确配置 #

• 先确认已安装django-filter依赖：

  pip install django-filter
  

• 在项目settings.py的INSTALLED_APPS中添加应用：

  INSTALLED_APPS = [
      # ...其他已注册应用
      'django_filters',
  ]
  

• 确认视图中正确导入过滤后端：
  在views.py顶部补充导入语句：

  from django_filters.rest_framework import DjangoFilterBackend
  

3. 冗余queryset写法（不影响过滤，但建议规范） #

Permit.objects.filter()虽然能返回全部数据，但更规范的写法是使用Permit.objects.all()：

queryset = Permit.objects.all()

验证修复 #

修改完成后重启服务，访问正确的接口路径，即可看到仅返回car_number=555的通行证数据。

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