如何在Django项目中实现表格筛选搜索及解决django-filter的assertationError问题

常规实现流程 #

• 安装配套依赖：核心使用django-filter库完成筛选逻辑封装，若需要快速生成结构化数据表格，可搭配django-tables2使用，执行安装命令pip install django-filter django-tables2即可。
• 项目配置接入：在项目settings.py的INSTALLED_APPS列表中添加'django_filters'；如果是基于DRF开发接口，可在REST_FRAMEWORK配置块中添加默认筛选后端；如果是传统模板渲染视图，可直接在视图层手动实例化筛选类，无需额外全局配置。
• 定义筛选规则：关联业务模型创建对应FilterSet类，在类中声明需要支持的筛选维度，比如文本字段模糊搜索、时间范围筛选、外键关联选项筛选等。
• 视图层数据对接：将用户传入的GET请求参数传入FilterSet实例，校验过滤规则后拿到筛选后的数据集，同时将筛选表单对象、筛选后的数据列表一同传入模板上下文。
• 页面层渲染交互：在模板中输出筛选表单供用户输入搜索条件，循环渲染筛选后的数据为表格行，实现多条件组合的搜索筛选效果。

django-filter报错解决方法 #

你遇到的AssertationError:setting 'Meta.model' without either 'Meta.fields' or 'Meta.exclude' has been deprecated.报错，核心原因是新版本django-filter已经废弃了“仅配置Meta.model、不指定字段范围就自动匹配所有字段”的旧逻辑，触发了内部校验规则。
具体修复分两种场景：

• 需要指定部分字段参与筛选
  在FilterSet的Meta类中显式添加fields参数，把所有需要支持筛选的模型字段名列在列表中即可，示例代码：

  from django_filters import FilterSet
  from .models import YourBusinessModel
  
  class YourModelFilter(FilterSet):
      class Meta:
          model = YourBusinessModel
          # 显式声明需要参与筛选的字段
          fields = ['name', 'status', 'create_time']
  

  如果希望直接把模型所有字段都纳入筛选范围，也可以直接写fields = '__all__'，同样能通过版本校验。
• 需要排除部分敏感字段参与筛选
  在Meta类中显式添加exclude参数，把不需要参与筛选的敏感字段、非业务字段列在排除列表中即可，示例代码：

  class YourModelFilter(FilterSet):
      class Meta:
          model = YourBusinessModel
          # 显式声明不需要参与筛选的字段
          exclude = ['is_deleted', 'raw_config']
  

注意：只要Meta类中只写了model参数，没有补充fields或exclude任意一个配置项，运行时就会直接抛出这个断言错误，配置时不能省略。

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