Django Admin中带through模型的多对多字段过滤失效问题

简化版模型结构 #

我们定义了三个关联模型：

Tour（行程）模型：

class Tour(models.Model):
    name = models.CharField(max_length=100)
    strecke = models.ManyToManyField(Strecke, through="Streckenreihenfolge")

Strecke（路段）模型：

class Strecke(models.Model):
    name = models.CharField(max_length=100)
    auftrag = models.ForeignKey("Auftrag", on_delete=models.CASCADE, null=True, blank=True)

Streckenreihenfolge（路段顺序）中间模型：

class Streckenreihenfolge(models.Model):
    strecke = models.ForeignKey(Strecke, on_delete=models.CASCADE)
    tour = models.ForeignKey("Tour", on_delete=models.CASCADE)
    reihenfolge = models.IntegerField()

问题场景 #

在Tour的Admin后台中，我希望限制Inline里可选择的Strecke选项，尝试在Inline类中重写formfield_for_foreignkey方法——该方法确实被调用了，但对可选选项没有任何影响：

@admin.register(Tour)
class TourAdmin(admin.ModelAdmin):

    class StreckenreihenfolgeAdminInline(admin.TabularInline):
        model = Streckenreihenfolge
        autocomplete_fields = ["strecke"]
        ordering = ["reihenfolge"]
        extra = 0

        def formfield_for_foreignkey(self, db_field, request, **kwargs):
            print(db_field.name)
            if db_field.name == 'strecke':
                kwargs['queryset'] = Strecke.objects.filter(auftrag_id__exact=8)
            return super().formfield_for_foreignkey(db_field, request, **kwargs)
    

inlines = [StreckenreihenfolgeAdminInline, ]

疑问：formfield_for_foreignkey对通过中间模型关联的多对多字段无效吗？

更新尝试 #

了解到formfield_for_manytomany对Inline表单无效，之后尝试用get_queryset()缩减查询集，但自动补全的内容依然没有被过滤。需求参考下图：

问题原因 #

核心问题出在autocomplete_fields的工作机制上：当你在Inline中使用autocomplete_fields时，Django会调用Strecke模型对应的Admin视图来处理自动补全请求，而非Inline里formfield_for_foreignkey返回的queryset。也就是说，你在Inline里设置的过滤规则，根本不会作用到自动补全的数据源上。

解决方案 #

要解决这个问题，需要自定义一个专属的自动补全视图，替代默认的Strecke Admin自动补全逻辑：

步骤1：创建自定义自动补全视图 #

from django.contrib.admin.views.autocomplete import AutocompleteJsonView
from .models import Strecke

class StreckeAutocompleteView(AutocompleteJsonView):
    def get_queryset(self):
        # 获取默认查询集
        qs = super().get_queryset()
        # 按需求过滤，这里以固定筛选auftrag_id=8为例
        qs = qs.filter(auftrag_id=8)
        return qs

步骤2：注册视图路由 #

在项目的urls.py中添加自定义视图的路由：

from django.urls import path
from .views import StreckeAutocompleteView

urlpatterns = [
    # 其他路由...
    path('admin/strecke-autocomplete/', StreckeAutocompleteView.as_view(model=Strecke), name='strecke-autocomplete'),
]

步骤3：修改Inline配置 #

去掉autocomplete_fields，改用自定义的Select2组件绑定新视图，同时保留formfield_for_foreignkey的过滤（确保非自动补全场景也生效）：

from django.contrib import admin
from django.contrib.admin.widgets import autocomplete
from .models import Tour, Streckenreihenfolge, Strecke

@admin.register(Tour)
class TourAdmin(admin.ModelAdmin):

    class StreckenreihenfolgeAdminInline(admin.TabularInline):
        model = Streckenreihenfolge
        ordering = ["reihenfolge"]
        extra = 0

        def formfield_for_foreignkey(self, db_field, request, **kwargs):
            if db_field.name == 'strecke':
                # 设置普通表单场景的查询集过滤
                kwargs['queryset'] = Strecke.objects.filter(auftrag_id__exact=8)
                # 绑定自定义自动补全视图
                kwargs['widget'] = autocomplete.Select2(url='strecke-autocomplete')
            return super().formfield_for_foreignkey(db_field, request, **kwargs)
    

inlines = [StreckenreihenfolgeAdminInline, ]

动态过滤扩展（可选） #

如果需要根据当前编辑的Tour动态过滤Strecke（比如关联同一个Auftrag），可以在视图中获取当前Tour的ID：

1. 在Inline的formfield_for_foreignkey中传递Tour ID到组件属性：

def formfield_for_foreignkey(self, db_field, request, **kwargs):
    if db_field.name == 'strecke':
        # 获取当前编辑的Tour ID
        tour_id = request.resolver_match.kwargs.get('object_id')
        kwargs['queryset'] = Strecke.objects.filter(auftrag_id__exact=8)
        widget = autocomplete.Select2(url='strecke-autocomplete')
        # 将Tour ID存入组件属性
        widget.attrs['data-tour-id'] = tour_id
        kwargs['widget'] = widget
    return super().formfield_for_foreignkey(db_field, request, **kwargs)

2. 在自定义视图中根据Tour ID动态过滤：

def get_queryset(self):
    qs = super().get_queryset()
    tour_id = self.request.GET.get('tour_id')
    if tour_id:
        from .models import Tour
        tour = Tour.objects.get(id=tour_id)
        # 假设Tour关联了Auftrag，替换为你的实际关联逻辑
        qs = qs.filter(auftrag=tour.auftrag)
    return qs

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