自定义非模型字段的filters.FilterSet显示[invalid name]问题求助

嘿，这个问题我之前也碰到过！Django FilterSet对于非模型字段，默认会因为找不到对应的模型字段映射而显示[invalid name]:，要改成自定义名称其实很简单，这里有两种实用方法：

方法1：直接给过滤器添加label参数 #

这是最直接的方式，在定义非模型字段的过滤器时，直接通过label参数指定你想要显示的名称：

class SomeFilter(filters.FilterSet):
    id = NumberInFilter(field_name='id')
    name = StringInFilter(field_name='name')
    # 这里添加label参数设置自定义名称
    custom_field_that_is_not_in_model = filters.CharFilter(label='我的自定义字段')

label参数会直接覆盖过滤器默认的显示文本，设置后前端就会显示你指定的名称，而不是[invalid name]:了。

方法2：重写get_form_class方法（动态设置场景） #

如果你的自定义名称需要根据业务逻辑动态生成，或者不想在字段定义时硬编码，可以重写FilterSet的get_form_class方法，在里面修改表单字段的label：

class SomeFilter(filters.FilterSet):
    id = NumberInFilter(field_name='id')
    name = StringInFilter(field_name='name')
    custom_field_that_is_not_in_model = filters.CharFilter()

    def get_form_class(self):
        form_class = super().get_form_class()
        # 动态设置自定义字段的label
        form_class.base_fields['custom_field_that_is_not_in_model'].label = f'动态生成的名称'
        return form_class

这种方式适合需要根据请求参数、上下文等动态调整名称的场景，灵活性更高。

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