Django登录表单POST提交未被loginPage视图捕获导致无法登录

首先用最直接的方式定位问题：在loginPage视图第一行加打印语句print(f"请求方法:{request.method}, 请求路径:{request.path}")，重启服务后触发登录，看控制台输出，按以下场景对应排查： #

场景1：控制台没打印任何内容 #

说明请求根本没到这个视图，排查方向：

• 打开浏览器F12开发者工具的「网络」面板，点击登录按钮看实际发出的请求地址：
  • 检查是不是页面上有JS代码给提交按钮绑了别的点击事件，拦截了默认表单提交逻辑，导致没有发正常的表单请求
  • 检查路由优先级：确认urls.py里，path('login/', views.loginPage, name='login')这条规则的上方，没有其他能匹配login/路径的路由（比如正则匹配的通用路由）把请求拦截到了别的视图
• 检查近期有没有改动过settings.py里的MIDDLEWARE配置，新增的自定义中间件有没有提前返回响应，把POST请求拦截在视图之外。

场景2：控制台打印的请求方法是GET #

这是最高发的情况，说明请求到了视图但方法不对，排查方向：

• 尾斜杠重定向问题：Django默认开启APPEND_SLASH=True，如果你当前访问的登录页地址是http://域名/login（末尾没有斜杠），而路由配置的是/login/带斜杠的路径，空action=""的表单会把请求先发到不带斜杠的/login地址，Django会返回301重定向到带斜杠的/login/，而301重定向会把POST请求自动转为GET请求，就会跳过POST分支。
  • 临时验证：手动在浏览器地址栏输入带尾斜杠的登录地址，再提交表单看是否正常
  • 永久修复：把表单的action属性改成明确的地址，用Django模板标签写action="{% url 'login' %}"，不要留空
• 检查表单代码：确认method="POST"属性没有拼写错误，没有被其他同名属性覆盖。

场景3：控制台打印请求方法是POST但分支逻辑没执行 #

这种情况一般是代码缩进错误，确认if request.method == 'POST':这行的缩进和视图内其他代码层级一致，没有被错误缩进到其他判断块里。 #

修复后需要修正的现有代码bug #

就算POST分支正常触发，你当前的视图代码还有几个会导致登录失败的问题，需要一并修改：

1. 缺少必要导入：只导入了User模型，authenticate、login、redirect三个依赖函数都没导入，运行时会直接抛NameError
2. 无效的用户查询逻辑：try块里User.objects.get(username = user)的user变量还没定义就被使用，而且这步查询完全多余，Django自带的authenticate方法本身就会处理用户不存在、密码错误的校验逻辑
3. 裸except会吞掉所有报错：不带异常类型的except会捕获所有错误（包括代码语法错误、变量名错误），导致调试时看不到真实报错信息，排查问题阶段不要这么写
4. 表单的input标签不需要额外加</input>闭合标签，属于不规范写法，虽然不影响功能但建议修正。

修正后的视图代码 #

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

def loginPage(request):
    if request.method == 'POST':
        username = request.POST.get('username')
        password = request.POST.get('password')
        user = authenticate(request, username=username, password=password)
        if user is not None:
            login(request, user)
            return redirect('home')
        else:
            # 可根据需要把错误信息传到模板渲染给用户
            print("用户名或密码错误")
    return render(request, 'base/login_register.html')

修正后的表单代码 #

<form method="POST" action="{% url 'login' %}"> 
    {% csrf_token %}
    <div class="row center">
        <input type="text" name="username" placeholder="Username" autocomplete="off">
        &nbsp;
        <input type="password" name="password" placeholder="Password" autocomplete="off">
        &nbsp;  
        <input type="submit" class="button-6-custom" value="login">
        &nbsp;
    </div>
</form>

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