Django Admin中choices类型CharField如何实现自动补全与筛选

首先明确报错原因：Django原生autocomplete_fields仅支持外键、多对多这类关联字段，你为普通CharField配置该参数就会触发你遇到的报错，使用下方方案时需要删除autocomplete_fields相关配置。
根据你的场景，提供3种可直接落地的实现方案：

方案1：无需改模型，用django-admin-autocomplete-filter实现列表页自动补全筛选 #

适合不想改动现有模型结构，只需要在列表页筛选栏实现school字段自动补全的场景：

1. 先安装依赖包django-admin-autocomplete-filter，并在项目settings.py的INSTALLED_APPS中添加admin_auto_filters
2. 修改Admin配置如下：

from django.contrib import admin
from .models import Academic
from admin_auto_filters.filters import AutocompleteFilter

# 自定义学校自动补全筛选器
class SchoolAutocompleteFilter(AutocompleteFilter):
    title = '所属学校'
    field_name = 'school'

@admin.register(Academic)
class AcademicAdmin(admin.ModelAdmin):
    # 必须把school加入搜索字段，才能支持筛选时的关键词匹配
    search_fields = ['surname', 'forename', 'school']
    # 加入自定义筛选器到列表筛选栏
    list_filter = [SchoolAutocompleteFilter,]

方案2：自定义表单Widget，实现新增/编辑页字段自动补全 #

如果需要在条目新增、编辑页面也支持school字段的输入自动补全，可以使用django-autocomplete-light扩展自定义表单组件：

from django.contrib import admin
from django import forms
from .models import Academic
from dal import autocomplete

class AcademicForm(forms.ModelForm):
    school = forms.ChoiceField(
        choices=Academic.SCHOOL_COLLEGE_SERVICE,
        widget=autocomplete.Select2(
            choices=Academic.SCHOOL_COLLEGE_SERVICE,
            attrs={'data-placeholder': '输入学校名称搜索'}
        ),
        required=False
    )
    class Meta:
        model = Academic
        fields = '__all__'

@admin.register(Academic)
class AcademicAdmin(admin.ModelAdmin):
    form = AcademicForm
    search_fields = ['surname', 'forename']

方案3：调整模型为外键关联，兼容原生Admin特性 #

如果后续学校选项会频繁变动，推荐调整模型结构，单独抽离School表，即可直接使用原生autocomplete_fields特性，无需额外依赖：

# 新增独立学校模型
class School(models.Model):
    name = models.CharField(max_length=100)
    def __str__(self):
        return self.name

# 修改原有Academic模型的school字段
class Academic(models.Model):
    # 原有其他字段不变
    school = models.ForeignKey(
        School,
        on_delete=models.SET_NULL,
        blank=True,
        null=True,
        verbose_name='所属学校'
    )

Admin配置直接使用原生特性即可：

@admin.register(School)
class SchoolAdmin(admin.ModelAdmin):
    # 配置学校表的搜索字段，给autocomplete_fields提供匹配依据
    search_fields = ['name']

@admin.register(Academic)
class AcademicAdmin(admin.ModelAdmin):
    autocomplete_fields = ['school']
    search_fields = ['surname', 'forename']

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