Django Admin中如何为外键字段自定义查询过滤选项？

完全可以单独为Invitation模型的user字段在Admin后台自定义查询范围，无需修改模型本身的查询逻辑。核心思路是通过自定义ModelAdmin类，重写formfield_for_foreignkey方法，专门对user字段的查询集做过滤。

实现示例 #

from django.contrib import admin
from django.contrib.auth.models import Group, User
from .models import Invitation

class InvitationAdmin(admin.ModelAdmin):
    def formfield_for_foreignkey(self, db_field, request, **kwargs):
        # 仅对user字段做过滤
        if db_field.name == 'user':
            # 获取名为"Director"的用户组
            director_group = Group.objects.get(name='Director')
            # 过滤出属于该组的用户
            kwargs['queryset'] = User.objects.filter(groups=director_group)
        # 调用父类方法处理其他字段
        return super().formfield_for_foreignkey(db_field, request, **kwargs)

# 用自定义的Admin类注册Invitation模型
admin.site.register(Invitation, InvitationAdmin)

异常处理优化（可选） #

如果"Director"组可能不存在，为避免抛出异常，可以做如下调整：

from django.contrib import admin
from django.contrib.auth.models import Group, User
from .models import Invitation

class InvitationAdmin(admin.ModelAdmin):
    def formfield_for_foreignkey(self, db_field, request, **kwargs):
        if db_field.name == 'user':
            director_group = Group.objects.filter(name='Director').first()
            if director_group:
                kwargs['queryset'] = User.objects.filter(groups=director_group)
            else:
                # 若组不存在，显示空的用户选项
                kwargs['queryset'] = User.objects.none()
        return super().formfield_for_foreignkey(db_field, request, **kwargs)

这个方案仅会影响Admin后台中user字段的可选范围，模型在其他业务逻辑中的查询不受任何影响。

内容的提问来源于stack exchange，提问作者Rafał Niemiec