Django后台管理站点无法为用户分配权限组的问题排查

以下是可能导致该问题的核心原因及排查方向：

• 自定义User模型权限关联配置错误
  如果你使用了自定义User模型（如示例中的api.models.User），需确保模型正确处理权限组关联：

  • 若继承AbstractUser，则默认自带groups和user_permissions多对多字段，无需额外配置；
  • 若继承AbstractBaseUser，必须手动添加groups字段，示例代码：

    from django.db import models
    from django.contrib.auth.models import Group, AbstractBaseUser, BaseUserManager
    
    class User(AbstractBaseUser):
        # 其他自定义字段
        groups = models.ManyToManyField(
            Group,
            verbose_name='权限组',
            blank=True,
            related_name='custom_user_set',  # 需避免与默认User模型的related_name冲突
            related_query_name='user'
        )
        # 同时需添加user_permissions字段（若需要）
    

• UserAdmin配置遗漏权限组字段
  检查admin.py中注册User模型的UserAdmin类，确保fieldsets或filter_horizontal/filter_vertical包含groups字段：

  • 若自定义了fieldsets，必须包含权限相关字段集，示例：

    from django.contrib.auth.admin import UserAdmin
    from api.models import User
    
    class CustomUserAdmin(UserAdmin):
        fieldsets = (
            (None, {'fields': ('username', 'password')}),
            ('个人信息', {'fields': ('email', 'nickname')}),
            ('权限配置', {'fields': ('is_staff', 'is_superuser', 'groups', 'user_permissions')}),
            ('关键日期', {'fields': ('last_login', 'date_joined')}),
        )
    
    admin.site.register(User, CustomUserAdmin)
    

  若遗漏groups字段，Admin后台的选择操作不会被持久化到数据库。

• 自定义保存逻辑覆盖了默认行为
  若在User模型的save()方法或UserAdmin的save_model()方法中自定义了逻辑，需确保调用了父类的对应方法，否则多对多关系（如用户与组的关联）不会被保存：

  • 示例save_model正确写法：

    def save_model(self, request, obj, form, change):
        # 自定义业务逻辑
        super().save_model(request, obj, form, change)  # 必须调用父类方法，处理多对多关系保存
    

• 数据库事务或缓存异常

  • 检查数据库中的auth_user_groups表（若使用默认表名），确认Admin操作后是否新增了用户与组的关联记录；
  • 若数据库有记录但Shell查询为空，可能是模型related_name配置冲突，导致查询关联数据时指向错误的表；
  • 尝试清除Django缓存后重新查询，避免缓存导致的显示不一致。

• 操作权限限制
  确保当前操作Admin的用户拥有修改用户权限组的权限，建议使用超级用户测试，排除权限配置导致的保存失败。

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