如何解决Django自定义用户登录时CSRF验证失败的403错误

开发者阿泽

2026-5-27

Django自定义登录表单CSRF验证失败（403错误）解决方案

我来帮你搞定这个登录时的CSRF 403错误！从你给出的终端警告和错误信息来看，核心问题就是模板渲染时没有传入包含CSRF令牌的请求上下文，导致{% csrf_token %}标签无法生成有效的令牌值。下面是一步步的解决方法：

1. 修正视图的模板渲染方式

这是最常见的原因，分两种情况处理：

如果你用的是Django 1.8及以上版本：直接使用render()函数替代render_to_response()，它会自动帮你处理RequestContext，不用手动传上下文实例：

from django.shortcuts import render

def custom_login(request):
    if request.method == 'POST':
        # 这里写你的登录验证逻辑
        pass
    # 直接传request给render函数即可
    return render(request, 'your_login_template.html', {})

如果你还在使用旧版Django（<1.8）：需要显式使用RequestContext来渲染模板：

from django.template import RequestContext
from django.shortcuts import render_to_response

def custom_login(request):
    if request.method == 'POST':
        # 登录逻辑
        pass
    # 必须传入context_instance=RequestContext(request)
    return render_to_response('your_login_template.html', {}, context_instance=RequestContext(request))

2. 检查模板中CSRF令牌的位置

确保{% csrf_token %}标签放在

标签内部，而且你的表单是用POST方法提交的（登录请求一定要用POST，别用GET）：

<form method="POST" action="{% url 'your_login_url_name' %}">
    {% csrf_token %} <!-- 这个必须在form里面 -->
    <!-- 你的表单字段 -->
    <div>
        <label>用户名:</label>
        <input type="text" name="username">
    </div>
    <div>
        <label>密码:</label>
        <input type="password" name="password">
    </div>
    <button type="submit">登录</button>
</form>

3. 确认CSRF中间件已启用

打开settings.py，检查MIDDLEWARE列表里有没有django.middleware.csrf.CsrfViewMiddleware，而且它的位置要正确（一般在会话中间件之后，认证中间件之前）：

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',  # 这个不能少！
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

4. 最后排查小细节

清除浏览器的缓存和Cookie，有时候旧的无效令牌会干扰验证；
确保你的请求确实是POST方法，GET请求不需要CSRF令牌，但登录用GET是不安全的，一定要改成POST。

按照上面的步骤来，应该就能解决这个403错误了！

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

如何解决Django自定义用户登录时CSRF验证失败的403错误

1. 修正视图的模板渲染方式 #

2. 检查模板中CSRF令牌的位置 #

3. 确认CSRF中间件已启用 #

4. 最后排查小细节 #

1. 修正视图的模板渲染方式

2. 检查模板中CSRF令牌的位置

3. 确认CSRF中间件已启用

4. 最后排查小细节