Django Admin如何设置默认过滤器且不与用户选择的过滤器冲突？

需求场景 #

需要给Django Admin的模型变更列表设置默认过滤规则：用户首次打开页面时自动按status="A"过滤；当用户手动选择其他status过滤器（如status="B"）时，默认过滤器自动失效，避免URL中出现冲突的过滤参数。

原方案问题分析 #

之前重写changelist_view的代码存在两个核心问题：

1. Django Admin的list_filter生成的过滤参数是status__exact而非status，原代码仅判断status参数存在与否，导致用户选择其他status后，URL同时保留status=A和status__exact=B，引发过滤逻辑冲突。
2. 未处理用户手动选择过滤器后，清除原默认参数的逻辑。

正确解决方案 #

修改changelist_view方法，同时处理添加默认过滤器和清理冲突参数两种场景：

from django.contrib import admin
from django.shortcuts import redirect
from django.urls import reverse
from .models import Person

class PersonAdmin(admin.ModelAdmin):
    list_display = ('name', 'status')
    list_filter = ('status',)

    def changelist_view(self, request, extra_context=None):
        # 生成GET参数的可变副本
        query = request.GET.copy()
        status_filter_keys = ['status', 'status__exact']
        
        # 场景1：用户已选择其他status过滤器，清理冲突的默认参数
        has_custom_status_filter = any(key in query for key in status_filter_keys if query.get(key) != 'A')
        if has_custom_status_filter:
            # 移除所有status相关的默认参数
            for key in status_filter_keys:
                query.pop(key, None)
            # 根据清理后的参数决定重定向路径
            if query:
                return redirect(f"{reverse('admin:Human_Resource_Management_person_changelist')}?{query.urlencode()}")
            else:
                return redirect(reverse('admin:Human_Resource_Management_person_changelist'))
        
        # 场景2：无任何status过滤器，添加默认的status=A（使用Admin标准参数格式）
        if not any(key in query for key in status_filter_keys):
            query['status__exact'] = 'A'
            return redirect(f"{reverse('admin:Human_Resource_Management_person_changelist')}?{query.urlencode()}")
        
        # 其他情况直接调用父类方法
        return super().changelist_view(request, extra_context=extra_context)

admin.site.register(Person, PersonAdmin)

代码说明 #

1. 冲突参数清理：先检查是否存在非"A"的status过滤参数，若存在则移除所有status相关的GET参数，彻底避免参数冲突。
2. 默认参数添加：当没有任何status过滤参数时，使用Django Admin标准的status__exact参数设置默认值"A"，确保与Admin过滤器生成的参数格式一致。
3. 重定向逻辑：所有参数修改后通过重定向生效，规避直接修改不可变的request.GET引发的AttributeError。

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