Django内置登录场景下如何简单检测登录失败并展示提示

你现在遇到的登录失败无提示、页面反复跳转的情况，根本原因是两个配置走偏了：

1. 没有让Django内置的登录视图直接接收登录表单的POST请求，反而让请求先跑到主页面，再被登录访问限制弹回登录页——这个来回跳转的过程，把原本携带的登录失败状态全丢了，自然没地方显示提示
2. 你的登录模板里压根没接收内置登录逻辑传过来的错误上下文，就算有错误信息也渲染不出来。

一步步调整即可解决 #

• 第一步：把登录路由配对
  Django 3.0以上版本不用自己写登录的视图逻辑，直接用内置的LoginView就行，在项目urls.py里加入对应配置：

  from django.urls import path
  from django.contrib.auth.views import LoginView
  
  urlpatterns = [
      # 其他原有路由
      # 这里一定要显式指到自己写的登录模板路径，别让Django找默认的registration/login.html，很容易匹配错
      path('login/', LoginView.as_view(template_name='你的登录模板存的路径.html'), name='login'),
  ]
  

  千万别把登录的POST请求指到首页路由，不然就会出现不管密码对不对都先跳首页的问题。

• 第二步：把前端表单的属性改对
  你原来的表单有两个常见问题：一是action写的#，没绑到实际的登录路由上；二是漏了Django要求的CSRF令牌，没这个的话POST请求会被直接拦截。改完的表单大概长这样：

  <form action="{% url 'login' %}" class="login-form" method="post">
    {% csrf_token %} <!-- 这个一定要加，不加的话啥认证逻辑都走不到 -->
    <input type="text" class="form-control input-field" placeholder="Username" name="username" required>
    <input type="password" class="form-control input-field" name="password" placeholder="Password" required>
  </form>
  

• 第三步：把错误提示的渲染块加上
  内置的LoginView用的是Django自带的AuthenticationForm，这个表单在做校验的时候，只要用户名密码对不上，就会自动把错误信息塞到form.errors这个模板变量里，根本不需要你自己写代码判断登录成没成。只要在表单的输入框下面加几行判断即可：

  {% if form.errors %}
    <div style="color: #ff4d4f; font-size: 14px; margin-top: 8px;">
      用户名或密码不正确，请核对后重试
    </div>
  {% endif %}
  

常见踩坑提醒 #

• 如果用的是2.x及更早版本的Django，内置登录视图的错误是通过messages框架传递的，这时候在模板里加一段messages渲染的代码就能拿到提示：

  {% if messages %}
    {% for message in messages %}
      <div class="err-tip">{{ message }}</div>
    {% endfor %}
  {% endif %}
  

• 全配完之后整个登录流程就顺了：输对密码的时候，Django会建好用户会话，直接跳转到你设置的登录成功地址（就是主页面，这时候因为已经登录了，不会被login_required拦截）；输错密码的时候，视图会直接把登录模板和错误信息一起返回，不会来回跳转，用户一提交就能看到提示。

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