Django自定义用户模型结合Bootstrap表单登录后redirect未跳转至仪表盘问题求助

嘿，我看你用自定义User模型结合Bootstrap表单做登录时，遇到了authenticate返回None、没法跳转到仪表盘的问题，咱们一步步来排查解决：

首先，最关键的问题：视图函数命名冲突 #

你自己的视图函数叫login，但Django的django.contrib.auth模块里也有一个login函数（就是你用来完成用户登录的那个核心函数），这会导致命名覆盖！当你在视图里调用login(request, user)时，实际调用的是你自己写的这个login视图函数，而不是Django官方的认证登录函数，这直接导致用户无法被正确标记为已登录，自然跳不过去。

修正方法：把你的视图函数改名，比如改成user_login：

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

def user_login(request):  # 改名避免和auth模块的login冲突
    if request.method == "POST":
        email = request.POST.get('email')
        password = request.POST.get('password')
        user = authenticate(request, email=email, password=password)
        if user is not None:
            login(request, user)  # 现在调用的是正确的Django auth登录函数
            return redirect('/dashboard')
        else:
            # 上下文要传字典格式，不然模板没法读取错误信息
            context = {'error_msg': "Provide Valid Credentials"}
            return render(request, "login.html", context)
    # 别忘了处理GET请求，首次访问登录页时返回表单页面
    return render(request, "login.html")

其次，urls.py的语法错误 #

你的urlpatterns里的路径后面少了逗号，这会导致Django解析路由时出错，无法正确匹配login和dashboard的路径：

from django.contrib import admin
from django.urls import path
from start_app.views import user_login, dashboard  # 导入改名后的视图

urlpatterns = [
    path('admin/', admin.site.urls),
    path('login/', user_login),  # 这里加逗号
    path('dashboard/', dashboard)  # 这里也加逗号（如果后面还有其他路径同理）
]

然后，自定义User模型的配置检查 #

要确保你的自定义User模型被Django正确识别为默认用户模型：

1. 在models.py里的User模型要设置USERNAME_FIELD = 'email'，让Django用邮箱作为认证的唯一标识：

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

class CustomUser(AbstractUser):
    username = None  # 如果不需要username字段就删掉
    email = models.EmailField(unique=True, verbose_name="邮箱")
    
    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = []  # 根据你的业务需求添加必填字段

    def __str__(self):
        return self.email

2. 在settings.py里必须指定自定义User模型（这一步非常重要，不设置的话Django还是会用默认的User模型）：

AUTH_USER_MODEL = 'start_app.CustomUser'  # 替换成你的app名和模型类名

另外，密码要正确哈希存储 #

如果你的用户是手动创建的（比如直接在shell里存明文密码），authenticate会直接返回None，因为Django只认哈希后的密码。创建用户时一定要用create_user方法：

from start_app.models import CustomUser
# 用create_user会自动帮你哈希密码
user = CustomUser.objects.create_user(email='test@example.com', password='your_password')
user.save()

最后，模板里可以优化错误提示 #

在你的login.html表单上方加上错误信息显示，让用户直观知道登录失败的原因：

{% if error_msg %}
<div class="alert alert-danger mt-3">{{ error_msg }}</div>
{% endif %}

<form method="POST" >
    {% csrf_token %}
    <!-- 你的Bootstrap表单内容保持不变 -->
</form>

按照上面的步骤改完，应该就能正常登录并跳转到仪表盘啦！

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