Django能否设置两个模型作为auth-user-model？报错求助

报错原因 #

AttributeError at /users/admin/login/
Manager isn't available; 'auth.User' has been swapped for 'vendors.Vendor'

这个错误的本质是你在settings.py中设置了AUTH_USER_MODEL = 'vendors.Vendor'，将Django默认的auth.User替换成了自定义的Vendor模型。此时系统全局只认可Vendor作为认证用户模型，任何试图直接调用auth.User或其他未被指定为AUTH_USER_MODEL的用户模型的操作都会触发该错误。

核心问题解答 #

Django不支持同时设置多个认证用户模型，AUTH_USER_MODEL是全局唯一配置项，整个项目只能指定一个模型作为默认的认证用户载体。

可行解决方案 #

方案1：单用户模型+角色扩展（推荐） #

这是Django官方推荐的多角色用户处理方式：

• 在统一的应用（比如accounts）中创建自定义用户模型，包含角色区分字段：

  # accounts/models.py
  from django.contrib.auth.models import AbstractUser
  from django.db import models
  
  class User(AbstractUser):
      ROLE_CHOICES = (
          ('user', '普通用户'),
          ('vendor', '商家'),
      )
      role = models.CharField(max_length=10, choices=ROLE_CHOICES, default='user')
  

• 在settings.py中配置：

  AUTH_USER_MODEL = 'accounts.User'
  

• 为不同角色创建关联的扩展模型，存储专属信息：

  # vendors/models.py
  from django.db import models
  from accounts.models import User
  
  class VendorProfile(models.Model):
      user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='vendor_profile')
      # 商家专属字段，比如营业执照号、店铺名称等
      business_license = models.CharField(max_length=50)
      shop_name = models.CharField(max_length=100)
  

方案2：自定义认证后端（仅特殊场景使用） #

如果必须保留两个独立的用户模型，需要自定义认证后端来支持多模型校验：

• 编写自定义认证后端：

  # users/backends.py
  from django.contrib.auth.backends import ModelBackend
  from users.models import User
  from vendors.models import Vendor
  
  class MultiModelBackend(ModelBackend):
      def authenticate(self, request, username=None, password=None, **kwargs):
          # 先尝试User模型认证
          try:
              user = User.objects.get(username=username)
              if user.check_password(password):
                  return user
          except User.DoesNotExist:
              pass
          # 再尝试Vendor模型认证
          try:
              vendor = Vendor.objects.get(username=username)
              if vendor.check_password(password):
                  return vendor
          except Vendor.DoesNotExist:
              pass
          return None
  
      def get_user(self, user_id):
          # 根据ID获取对应模型的用户
          try:
              return User.objects.get(pk=user_id)
          except User.DoesNotExist:
              try:
                  return Vendor.objects.get(pk=user_id)
              except Vendor.DoesNotExist:
                  return None
  

• 在settings.py中配置认证后端：

  AUTHENTICATION_BACKENDS = [
      'users.backends.MultiModelBackend',
      # 保留默认后端可选
      'django.contrib.auth.backends.ModelBackend',
  ]
  

• 注意：这种方式会带来诸多兼容问题，比如admin站点用户管理、权限系统集成、第三方库适配等，需要大量额外开发工作。

当前报错临时修复 #

检查settings.py中的AUTH_USER_MODEL配置，确认你实际需要使用的默认用户模型（users.User或vendors.Vendor），只保留唯一的配置项，即可解决该报错。

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