Django自定义注册用户无法登录问题求助及认证原理咨询

嘿，我来帮你搞定这个登录问题！核心原因很简单：你自定义的UserCredentials模型和Django自带的认证系统完全不兼容，默认的登录/验证只会认Django auth系统的用户表，而你注册的用户存在自己的表，自然登不上。

问题根源拆解 #

你现在的代码有两个关键问题：

1. 你创建了独立的UserCredentials模型，把用户数据存在userdetails表，但Django的authenticate()和login()方法只会去查询Django auth系统的用户表（默认是auth_user，也就是你用createsuperuser创建用户的表）。
2. 你直接把明文密码存在了user_password字段，而Django auth系统要求密码必须是哈希加密后的格式，就算你把用户数据移到auth_user表，明文密码也通不过验证。

修复方案：改用Django认证系统的用户模型 #

Django的auth系统已经帮我们做好了用户管理、密码哈希、会话维护等功能，我们只需要基于它扩展即可，不用自己从零造轮子。

步骤1：扩展Django的用户模型（推荐） #

如果你的项目还处于早期阶段，最好用AbstractUser扩展自定义用户模型，这样既能保留auth系统的所有功能，还能添加自己需要的字段：

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

class CustomUser(AbstractUser):
    # 这里可以添加你需要的额外字段，比如原模型里的user_email（不过AbstractUser已经自带email字段了）
    # 示例：phone_number = models.CharField(max_length=15, blank=True, null=True)
    
    class Meta:
        db_table = "custom_user"  # 可选，自定义表名，不想改的话可以删掉这行

然后在项目的settings.py里配置使用这个自定义模型：

# settings.py
AUTH_USER_MODEL = "你的app名.CustomUser"  # 替换成你的实际app名称，比如"accounts.CustomUser"

步骤2：修改用户注册表单 #

用Django自带的UserCreationForm（专门用于用户注册的表单，自动处理密码哈希），或者基于自定义模型写ModelForm：

# models.py 继续添加
from django.contrib.auth.forms import UserCreationForm

class UserForm(UserCreationForm):
    class Meta:
        model = CustomUser
        fields = ["username", "email"]  # 这里可以根据需要添加字段，比如你原来的user_email就是自带的email

步骤3：简化注册视图 #

现在表单会自动处理用户创建和密码哈希，视图可以简化很多：

# views.py
from django.contrib.auth import login
from .forms import UserForm
from django.shortcuts import render, redirect

def signup(request):
    if request.method == 'POST':
        form = UserForm(request.POST)
        if form.is_valid():
            user = form.save()  # 这里创建的是CustomUser实例，自动哈希密码
            login(request, user)  # 直接登录，不需要再authenticate
            return redirect('/UserPage')
    else:
        form = UserForm()
    return render(request, 'signup.html', {'form': form})

步骤4：迁移数据库 #

执行以下命令更新数据库表：

python manage.py makemigrations
python manage.py migrate

关于Django数据存储与登录验证的解释 #

表单数据存储 #

• 当你调用ModelForm的save()方法时，数据会被保存到Meta.model指定的模型对应的数据库表中。
• Django auth系统的表单（比如UserCreationForm）会自动对密码进行PBKDF2哈希加密，不会存储明文密码，这是为了安全。而你之前的自定义表单直接存明文密码，既不安全，也不兼容auth系统。

登录验证流程 #

当你调用authenticate(username=xxx, password=xxx)时，Django会做这些事：

1. 去AUTH_USER_MODEL指定的表中查找匹配的用户名（或邮箱，可通过配置修改）。
2. 取出该用户的哈希密码，用同样的算法对输入的原始密码进行哈希。
3. 比对两个哈希值：如果一致，返回该用户实例；否则返回None。
4. 调用login(request, user)时，Django会创建会话，把用户ID存储在浏览器的session中，后续请求通过session识别用户身份。

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