Django 4.2中为反向外键字段实现后台自动完成多选组件

现有如下模型结构：

# models.py
class Group(models.Model):
    name = models.CharField()

class Book(models.Model):
    name = models.CharField()
    group = models.ForeignKey(Group, on_delete=models.SET_NULL, related_name='books', related_query_name="book", null=True, blank=True)

需要在Group的Admin表单中添加书籍多选框，此前通过FilteredSelectMultiple实现，但当书籍数量超过10万条时，表单加载极慢（组件会一次性加载全部数据）。尝试替换为AutocompleteSelectMultiple组件，但该组件要求Group模型必须有对应多对多字段，自定义重写AutocompleteMixin未成功，需解决反向外键场景下的自动完成多选需求（仅选择已有书籍，无需内联创建），使用Django 4.2版本。

1. 配置Book模型的Admin自动搜索支持 #

先为Book模型注册Admin并配置search_fields，Django会自动生成对应的自动完成API视图：

# admin.py
from django.contrib import admin
from .models import Group, Book

@admin.register(Book)
class BookAdmin(admin.ModelAdmin):
    search_fields = ['name']  # 指定用于自动搜索的字段，比如书籍名称

2. 自定义反向外键自动完成Widget #

继承AutocompleteSelectMultiple，重写get_url方法，直接指向Book的自动完成API地址，绕过组件对多对多字段的依赖：

from django.contrib.admin.widgets import AutocompleteSelectMultiple
from django.urls import reverse

class ReverseForeignKeyAutocompleteMultiple(AutocompleteSelectMultiple):
    def get_url(self):
        # 替换为你的app标签，格式为 admin:<app_label>_<model_name>_autocomplete
        return reverse('admin:library_book_autocomplete')

3. 更新Group的表单与Admin配置 #

替换原表单中的FilteredSelectMultiple为自定义Widget，其余逻辑保持不变：

from django.forms import ModelForm, ModelMultipleChoiceField

class Group_ModelForm(ModelForm):
    books = ModelMultipleChoiceField(
        queryset=Book.objects.all(),
        widget=ReverseForeignKeyAutocompleteMultiple(None, admin.site),
        required=True,
        label='Books'
    )
    
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        if 'instance' in kwargs and kwargs['instance'] is not None:
            self.fields['books'].initial = kwargs['instance'].books.all()

@admin.register(Group)
class Group_ModelAdmin(admin.ModelAdmin):
    list_display = ['name']
    list_display_links = ['name']
    fields = ['books', 'name']
    form = Group_ModelForm

    def save_model(self, request, obj, form, change):
        super().save_model(request, obj, form, change)
        if change:
            Book.objects.filter(group=obj).update(group=None)
        form.cleaned_data['books'].update(group=obj)

• 自定义Widget通过get_url直接绑定Book的自动完成API，避开了默认组件对多对多字段的强制依赖。
• Book Admin的search_fields配置让API仅返回匹配输入的书籍数据，不会一次性加载全部10万条记录，大幅提升表单加载速度。
• 原有保存逻辑完全保留，仍能正确维护Group与Book的外键关联关系。

• 务必将reverse中的admin:library_book_autocomplete替换为你实际的app标签和模型名称，格式严格遵循admin:<app_label>_<model_name>_autocomplete。
• 确保Django Admin的静态资源已正确加载，自动完成组件依赖Admin内置的JS和CSS文件。

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