Django中authenticate返回null致无法登录问题及解决

问题根源 #

Django自带的authenticate()函数默认只认内置的User模型，你用的自定义Signups模型不在它的默认认证范围内，所以哪怕数据库里有匹配的账号密码，也会返回None，自然登不上。

具体解决步骤 #

1. 把自定义模型设为项目默认用户模型 #

在项目的settings.py里加一行配置，指定你的Signups作为全局默认用户模型：

AUTH_USER_MODEL = '你的应用名.Signups'

划重点：这个配置必须在第一次执行migrate前设置！如果已经跑过migrate，要么重置数据库，要么写数据迁移脚本把旧User表的数据导到Signups里，不然会出现表结构冲突。

2. 确保自定义模型符合Django要求 #

你的Signups模型得继承AbstractUser或者AbstractBaseUser，别直接继承models.Model。如果用AbstractUser会自带username、password这些必填字段，还能加自定义字段，示例：

from django.contrib.auth.models import AbstractUser
from django.db import models

class Signups(AbstractUser):
    # 这里加你需要的自定义字段，比如手机号
    phone = models.CharField(max_length=11, blank=True, null=True)

如果用AbstractBaseUser，还得手动设置USERNAME_FIELD、REQUIRED_FIELDS这些属性，相对麻烦，优先推荐AbstractUser。

3. 修复登录视图的认证逻辑 #

配置完默认模型后，authenticate()就能正常识别你的Signups用户了，登录视图可以这么写：

from django.contrib.auth import authenticate, login
from django.shortcuts import redirect, render

def login_view(request):
    if request.method == 'POST':
        username = request.POST.get('username')
        password = request.POST.get('password')
        # 现在authenticate能正确匹配Signups模型的用户了
        user = authenticate(request, username=username, password=password)
        if user:
            login(request, user)
            # 登录成功直接跳转到你要的展示页面
            return redirect('你的目标页面URL名称')
        else:
            return render(request, 'login.html', {'error': '用户名或密码不对'})
    return render(request, 'login.html')

4. 检查登录表单的提交路径 #

确保你的登录表单action属性指向正确的登录视图URL，比如用Django的URL反向解析：

<form method="post" action="{% url 'login_view的URL名称' %}">
    {% csrf_token %}
    <input type="text" name="username" placeholder="用户名">
    <input type="password" name="password" placeholder="密码">
    <button type="submit">登录</button>
</form>

额外提醒 #

• 如果之前已经创建了内置的auth_user表，记得清理旧数据或者迁移到Signups表，不然会有冗余数据。
• 后台管理（admin）如果要管理Signups用户，需要在admin.py里注册自定义模型，比如：

from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import Signups

admin.site.register(Signups, UserAdmin)

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