Django项目中django-filters筛选字段未在HTML显示的问题

核心问题排查与修复： #

1. FilterSet实例被错误替换为查询集

你在视图里直接把ImageForeignFilter(...).qs赋值给了images变量，这导致模板里调用images.form时，images已经变成了QuerySet对象（无form属性），所以表单只显示提交按钮，筛选字段完全不渲染。

修复后的views.py：

def image_list(request):
    # 先保存FilterSet实例，不要直接取qs
    image_filter = ImageForeignFilter(
        request.GET, 
        queryset=Image.objects.filter(status=Image.Status.PUBLISHED).order_by('created')
    )
    # 从实例中获取过滤后的查询集
    filtered_images = image_filter.qs
    paginator = Paginator(filtered_images, 15)

    page = request.GET.get('page')
    try:
        page_number = paginator.page(page)
    except PageNotAnInteger:
        page_number = paginator.page(1)
    except EmptyPage:
        page_number = paginator.page(paginator.num_pages)
    # 把FilterSet实例传到模板，而不是查询集
    return render(request, 'images/image/list.html', {
        'section': 'images',
        'image_filter': image_filter, 
        'page_number': page_number
    })

2. 自定义筛选字段未关联模型对应字段

你的ImageForeignFilter里定义了wydawca字段，但Image模型中对应的外键是publisher，未指定field_name的话，django-filters找不到对应的模型字段，导致该筛选项无法显示。

修复后的filters.py中ImageForeignFilter部分：

class ImageForeignFilter(django_filters.FilterSet):
    wydawca = django_filters.ModelChoiceFilter(
        field_name='publisher',  # 必须指定对应模型的外键字段名
        queryset=Publisher.objects.all(),
        empty_label="Wszyscy wydawcy",
        label="Wydawca",
        widget=forms.Select(attrs={'class': 'form-control'}),
    )

    class Meta:
        model = Image
        fields = ['created', 'wydawca']

3. 模板中的错误修正

模板里存在变量名错误和逻辑错误，一并修正：

{% extends "base.html" %}
{% load crispy_forms_tags %}
{% load i18n %}

{% block title %}Title{% endblock %}
{% block content %}

<div id="image-list">
  <form method="get">
    <!-- 改为使用FilterSet实例的form -->
    {{ image_filter.form.as_p }}
    <input type="submit"/>
  </form>

  <!-- 遍历分页后的对象，变量名改为image更合理 -->
  {% for image in page_number %}
    {{ image.publisher.name }}  <!-- 显示出版社名称，模型里无wydawca字段 -->
  {% endfor %}
                
{% include "images/image/list_images.html" %}
<!-- 分页传递正确的分页对象page_number -->
{% include "pagination.html" with page=page_number %}
</div>
{% endblock %}

额外说明 #

• 确保已安装并在INSTALLED_APPS中注册django_filters，否则筛选功能无法正常工作。

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