Django-filter动态过滤器实现中的类属性陷阱

在Django-filter项目中实现动态过滤器时，开发者经常会遇到一个常见的陷阱：动态添加的过滤器会在后续请求中被错误地保留。这个问题源于对类属性和实例属性的理解不足。

问题现象

当开发者尝试根据请求参数动态添加过滤器时，第一次请求能够正确返回结果，但后续请求会保留之前添加的过滤器。例如：

1. 第一次请求商品分类A时，系统正确添加了分类A特有的过滤器
2. 第二次请求商品分类B时，结果中却包含了分类A和分类B的过滤器混合

问题根源

这个问题源于开发者错误地修改了base_filters这个类级别属性，而不是实例级别的filters属性。在Python中，类属性是共享的，所有实例都会访问同一个类属性。

在Django-filter的实现中：

• base_filters是类级别的过滤器定义
• filters是实例级别的过滤器集合

直接修改base_filters会影响该Python进程中所有后续创建的FilterSet实例，这与Django表单中的base_fields行为类似。

正确实现方式

正确的做法是在实例级别操作filters字典，而不是类级别的base_filters：

def __init__(self, *args, **kwargs):
    super(ProductFilter, self).__init__(*args, **kwargs)
    
    # 确定当前分类
    cat = self._determine_category()
    
    if cat:
        attributes = Attribute.objects.prefetch_related('choices').filter(
            categories__in=cat.get_ancestors(include_self=True)
        )
        
        for attr in attributes:
            if attr.is_stringy:
                self.filters[attr.name] = django_filters.MultipleChoiceFilter(
                    method='get_attribute_choice',
                    choices=[(choice.id, choice) for choice in attr.choices.all()],
                    label=attr.name
                )
                self.filters[attr.name].field_name = attr.name
            elif attr.is_boolean:
                self.filters[attr.name] = django_filters.BooleanFilter(
                    method='get_attribute_boolean',
                    label=attr.name
                )
                self.filters[attr.name].field_name = attr.name

深入理解

这种类属性与实例属性的区别是Python面向对象编程中的核心概念。在Django和Django-filter中，这种模式被广泛使用：

1. 类属性用于定义默认行为或共享配置
2. 实例属性用于保存特定实例的状态

当我们需要根据请求动态修改行为时，应该总是操作实例属性，避免污染类属性导致全局影响。

最佳实践建议

1. 在实现动态过滤器时，优先考虑使用filters而不是base_filters
2. 如果需要完全重置过滤器，可以创建新的FilterSet实例
3. 对于复杂的动态过滤需求，可以考虑使用工厂模式生成不同的FilterSet类
4. 在修改过滤器前，先打印或检查当前过滤器状态，确保符合预期

理解这一点不仅对Django-filter有效，对于所有需要动态修改行为的Django组件（如表单、视图等）都适用。正确区分类级别和实例级别的操作是编写可靠Django应用的关键。