使用Django2.0.2+Mac10.13+Postman5.5.2登录失败问题求助

嘿，我看你在Postman里调用登录接口时遇到了失败的情况，结合你给出的Web端代码和环境（Django 2.0.2、MacOS 10.13、Postman 5.5.2），我梳理了几个最可能的原因和解决办法，你可以一步步排查：

1. CSRF令牌验证拦截（最常见） #

Django默认开启了CSRF保护机制，Web端的表单因为嵌入了{% csrf_token %}标签，所以能正常通过验证，但Postman作为API工具，默认不会携带CSRF令牌，这会直接导致请求被拒绝。

解决办法： #

• 临时调试用：给登录视图添加@csrf_exempt装饰器，跳过CSRF验证（注意：生产环境不要随便用，只在调试API时临时用）：

  from django.views.decorators.csrf import csrf_exempt
  
  @csrf_exempt
  def login(request):
      # 你的原有代码
  

• 规范做法：先通过GET请求访问登录页面，从响应的HTML里提取csrfmiddlewaretoken的值，然后在Postman的POST请求里，把这个令牌放到form-data或者请求头X-CSRFToken中，和用户名密码一起提交。

2. 请求数据格式不匹配 #

你的代码里用request.POST来获取表单数据，这只适用于Web表单默认的application/x-www-form-urlencoded或multipart/form-data格式，但如果Postman里你选了raw->JSON格式提交数据，Django会把JSON数据放到request.body里，不会解析到request.POST，直接导致form.is_valid()失败。

解决办法： #

• 调整Postman的请求体格式：切换到form-data或x-www-form-urlencoded，然后填入username和password字段；
• 或者修改代码支持JSON格式提交：

  import json
  from django.contrib.auth import authenticate, login
  
  def login(request):
      form = UserCreateForm()
      if request.method == "POST":
          # 判断请求格式是否为JSON
          if request.content_type == 'application/json':
              try:
                  data = json.loads(request.body)
                  form = UserCreateForm(data)
              except json.JSONDecodeError:
                  return render(request, 'blog/user_create.html', {'form': form, 'errors': '无效的JSON格式'})
          else:
              form = UserCreateForm(request.POST)
          
          if form.is_valid():
              username = form.cleaned_data['username']
              password = form.cleaned_data['password']
              user = authenticate(username=username, password=password)
              if user is not None and user.is_active:
                  login(request, user)
                  return redirect('/')
          # 表单验证失败时返回错误信息
          return render(request, 'blog/user_create.html', {'form': form, 'errors': form.errors})
      return render(request, 'blog/user_create.html', {'form': form})
  

3. 表单验证失败但无错误提示 #

你的原有代码里，如果form.is_valid()不通过，或者用户验证失败（比如用户名密码错误），只是返回了表单，但没有传递错误信息，你根本不知道哪里出了问题。

解决办法： #

在返回的模板上下文里加入错误信息，同时可以在控制台打印错误方便排查：

if form.is_valid():
    # 原有逻辑
else:
    # 打印错误到终端，方便调试
    print("表单验证错误：", form.errors)
    return render(request, 'blog/user_create.html', {'form': form, 'errors': form.errors})

然后在Postman里查看返回的页面，就能看到具体的错误提示了。

4. 函数命名冲突 #

你的视图函数叫login，而你又调用了Django自带的login(request, user)函数，虽然Python里局部作用域的函数会覆盖全局，但有时候会引发一些奇怪的问题，比如调用错误的函数。

解决办法： #

把视图函数改名，或者给Django的login函数起别名：

from django.contrib.auth import login as auth_login

def user_login(request):
    form = UserCreateForm()
    if request.method == "POST":
        # 原有逻辑
        if user is not None and user.is_active:
            auth_login(request, user)
            return redirect('/')
    # 后续逻辑

建议你先从CSRF和请求格式这两个点入手排查，这是Postman调用Django接口最容易踩的坑。

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