Django Admin中Autocomplete字段覆盖ModelForm过滤规则的问题

原因分析 #

当给外键字段设置autocomplete_fields后，Django Admin会忽略ModelForm中该字段的queryset配置，转而调用关联模型（此处为Task）对应Admin类的get_queryset方法获取候选数据，这就是ModelForm过滤规则失效、改用TaskAdmin分组逻辑的原因。

解决方案 #

方案1：在当前ModelAdmin中重写get_autocomplete_queryset

针对需要自定义过滤的autocomplete字段，在管理关联对象的ModelAdmin里重写该方法，指定特定查询集，不影响TaskAdmin自身逻辑：

from django.contrib import admin
from .models import YourModel, Task
from .constants import TaskStatus

class YourModelAdmin(admin.ModelAdmin):
    autocomplete_fields = ['task']
    form = YourModelForm

    def get_autocomplete_queryset(self, request, model, field_name):
        if field_name == 'task' and model == Task:
            # 仅返回状态为ASSIGNED的任务
            return Task.objects.filter(status=TaskStatus.ASSIGNED)
        # 其他字段沿用默认逻辑
        return super().get_autocomplete_queryset(request, model, field_name)

方案2：修改TaskAdmin的get_queryset，合并过滤条件

如果所有使用Task autocomplete的场景都需要ASSIGNED状态过滤，可以修改TaskAdmin的查询逻辑，结合原有用户分组规则：

class TaskAdmin(admin.ModelAdmin):
    def get_queryset(self, request):
        qs = super().get_queryset(request)
        # 判断是否为autocomplete请求
        if request.GET.get('autocomplete') or 'autocomplete' in request.path:
            qs = qs.filter(status=TaskStatus.ASSIGNED)
        # 保留原有的用户分组过滤
        qs = qs.filter(group=request.user.group)
        return qs

方案3：自定义Autocomplete视图（复杂场景适用）

完全独立于TaskAdmin配置，自定义视图控制查询集：

1. 创建自定义视图：

from django.contrib.admin.views.autocomplete import AutocompleteJsonView
from .models import Task
from .constants import TaskStatus

class TaskAssignedAutocompleteView(AutocompleteJsonView):
    def get_queryset(self):
        qs = Task.objects.filter(status=TaskStatus.ASSIGNED)
        # 保留默认搜索逻辑
        search_term = self.request.GET.get('term', '')
        if search_term:
            qs = qs.filter(name__icontains=search_term)  # 替换为实际搜索字段
        return qs

2. 在urls.py注册视图：

from django.urls import path
from .views import TaskAssignedAutocompleteView

urlpatterns = [
    # 其他路由
    path('admin/task-assigned-autocomplete/', TaskAssignedAutocompleteView.as_view(model=Task), name='task-assigned-autocomplete'),
]

3. 在ModelForm中指定视图：

from django import forms
from .models import YourModel

class YourModelForm(forms.ModelForm):
    task = forms.ModelChoiceField(
        queryset=Task.objects.filter(status=TaskStatus.ASSIGNED),
        widget=forms.Select(attrs={
            'data-autocomplete-url': '/admin/task-assigned-autocomplete/'
        })
    )

    class Meta:
        model = YourModel
        fields = '__all__'

总结 #

优先选择方案1，代码量少且仅针对当前ModelAdmin生效，逻辑清晰；全局需要过滤规则时用方案2；极端复杂场景再考虑方案3。

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