Django-filters设置min/max price占位符时遇字段错误的解决咨询

报错TypeError: 'Meta.fields' must not contain non-model field names: min_price, max_price的核心原因是：FilterSet.Meta.fields只能指定模型中实际存在的字段名，而min_price、max_price是你自定义的过滤器名称，不属于Product模型的字段，因此被Django Filter判定为非法。

另外代码中还有一个小问题：NumberFilter搭配RangeWidget是错误的——RangeWidget是为RangeFilter（同时处理区间上下限的单个过滤器）设计的，NumberFilter对应单个输入框，应该使用NumberInput或TextInput。

1. 修正filters.py代码 #

import django_filters
from django.forms.widgets import NumberInput
from .models import Product

class ProductFilter(django_filters.FilterSet):
    min_price = django_filters.NumberFilter(
        field_name="price", 
        lookup_expr='gt',
        widget=NumberInput(attrs={'placeholder': '最低价格'})
    )
    max_price = django_filters.NumberFilter(
        field_name="price", 
        lookup_expr='lt',
        widget=NumberInput(attrs={'placeholder': '最高价格'})
    )

    class Meta:
        model = Product
        fields = []  # 空列表表示不自动生成任何模型字段的过滤器，仅使用自定义过滤器

2. 修正视图类的属性名 #

你的ProductListView中使用了错误的属性名filter_set，Django Filter要求的正确属性名是filterset_class，修改views.py：

from django_filters.views import FilterView
from .models import Product
from .filters import ProductFilter

class ProductListView(FilterView):
    template_name = "product/product_list.html"
    queryset = Product.objects.all()
    filterset_class = ProductFilter  # 修正属性名

说明 #

• 当你手动定义了所有需要的过滤器时，Meta.fields可以设为空列表，避免Django自动生成多余的过滤器。如果后续需要对模型的其他字段添加默认过滤器，再将对应字段名加入fields即可。
• 使用NumberInput可以确保输入框只接受数字输入，同时通过attrs设置占位符，满足你的需求。

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