Django REST Framework多字段认证：自定义登录逻辑报错求助

问题原因 #

你自行编写的登录逻辑没有调用Django提供的authenticate()函数，而是直接手动查询用户模型的特定字段（比如phone_number），导致无法触发AUTHENTICATION_BACKENDS中配置的多后端认证流程。当传入邮箱时，代码错误地将邮箱值传入phone_number字段查询，自然会抛出类型不匹配的错误。

解决步骤 #

1. 核心：使用authenticate()函数处理认证 #

Django的authenticate()函数会自动遍历settings.py中AUTHENTICATION_BACKENDS配置的所有后端，逐个尝试认证，直到找到匹配的用户。这也是默认obtain_auth_token视图能同时支持邮箱和手机号登录的原因。

2. 修改自定义登录视图代码 #

替换手动查询用户的逻辑，改用authenticate()：

from django.contrib.auth import authenticate
from rest_framework import status
from rest_framework.response import Response
from rest_framework.views import APIView
from rest_framework.authtoken.models import Token

class CustomLoginView(APIView):
    def post(self, request):
        # 获取前端传入的登录凭证（可以是邮箱或手机号）
        login_credential = request.data.get('login_credential')
        password = request.data.get('password')

        # 调用authenticate，这里的username参数会被各个后端自行映射到对应字段
        user = authenticate(request, username=login_credential, password=password)

        if user:
            token, _ = Token.objects.get_or_create(user=user)
            return Response({'token': token.key}, status=status.HTTP_200_OK)
        else:
            return Response({'error': '无效的登录凭证或密码'}, status=status.HTTP_401_UNAUTHORIZED)

3. 确认自定义手机号认证后端的实现 #

确保你的手机号后端正确实现了authenticate方法，能处理传入的username参数（即登录凭证）：

from django.contrib.auth.backends import ModelBackend
from .models import CustomUser

class PhoneBackend(ModelBackend):
    def authenticate(self, request, username=None, password=None, **kwargs):
        try:
            # 这里的username对应前端传入的手机号
            user = CustomUser.objects.get(phone_number=username)
            if user.check_password(password):
                return user
        except CustomUser.DoesNotExist:
            # 找不到用户时返回None，让下一个后端继续尝试
            return None

4. 检查settings.py的认证后端配置 #

确保AUTHENTICATION_BACKENDS包含你的默认后端和自定义手机号后端，顺序不影响（authenticate会逐个尝试直到成功）：

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend',  # 基于USERNAME_FIELD（email）的默认认证
    'your_app.backends.PhoneBackend',  # 自定义手机号认证后端
]

关键说明 #

• authenticate()的username参数是通用的，各个认证后端会自行决定将其映射到用户模型的哪个字段（默认后端映射到USERNAME_FIELD即email，手机号后端映射到phone_number）。
• 不要手动通过User.objects.get(phone_number=xxx)或User.objects.get(email=xxx)查询用户，这种方式会绕过多后端认证流程，只能支持单一登录方式。

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