Django多用户类型多对多字段问题：Admin面板角色框为空

你在实现多角色用户系统时，遇到了管理面板创建用户时roles字段显示空白框的问题，以下是解决步骤：

1. 确保Role模型的实例已创建 #

你的Role模型依赖数据迁移自动生成实例，但如果迁移未执行或未正确创建数据，下拉框自然没有选项。

创建数据迁移的步骤：

• 运行 python manage.py makemigrations --empty yourappname（替换yourappname为你的应用名）生成空迁移文件。
• 打开生成的迁移文件，在operations里添加创建Role实例的代码：

from django.db import migrations

def create_roles(apps, schema_editor):
    Role = apps.get_model('yourappname', 'Role')
    roles = [
        (1, 'student'),
        (2, 'teacher'),
        (3, 'secretary'),
        (4, 'supervisor'),
        (5, 'admin'),
    ]
    for role_id, role_name in roles:
        Role.objects.get_or_create(id=role_id, defaults={'id': role_id})

class Migration(migrations.Migration):

    dependencies = [
        ('yourappname', '0001_initial'), # 替换为你的初始迁移文件名
    ]

    operations = [
        migrations.RunPython(create_roles),
    ]

• 运行 python manage.py migrate 执行迁移，此时Role表中会生成所有预设角色。

2. 配置Django Admin优化角色选择 #

默认的多对多字段在admin里显示不够直观，你可以在admin配置里使用filter_horizontal或filter_vertical优化，同时确保正确注册自定义User模型：

在admin.py中添加：

from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import User, Role

class CustomUserAdmin(UserAdmin):
    # 把roles字段添加到用户创建/编辑页面
    fieldsets = UserAdmin.fieldsets + (
        ('角色信息', {'fields': ('roles',)}),
    )
    # 使用横向筛选框，更方便多选
    filter_horizontal = ('roles',)

admin.site.register(User, CustomUserAdmin)
admin.site.register(Role)

完成以上两步后，刷新管理面板，用户创建页面的roles字段就会显示所有可选角色，支持多选了。

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