Django用户创建后登录失败问题排查求助

1. 检查密码哈希存储是否正确 #

Django 默认使用 PBKDF2 算法存储密码，若创建用户时直接给 password 字段赋值明文（未调用 set_password()），会导致密码未被哈希，登录时必然失败。

• 验证方式：打开 Django Shell 执行：

  from django.contrib.auth.models import User
  user = User.objects.get(username='你的用户名')
  print(user.password)
  

  若输出为明文或不以 pbkdf2_sha256$ 开头，说明存储错误。解决：调用 user.set_password('新密码') 后执行 user.save()。

2. 确认认证后端配置 #

检查 settings.py 中的 AUTHENTICATION_BACKENDS，默认应为 ['django.contrib.auth.backends.ModelBackend']。若自定义了认证后端，需确保其逻辑正确（如正确验证用户名密码、返回有效用户对象）。

• 配置示例：

  AUTHENTICATION_BACKENDS = ['django.contrib.auth.backends.ModelBackend']
  

3. 校验登录视图逻辑 #

确保登录视图正确使用 authenticate() 和 login() 方法，且字段名匹配：

• 正确逻辑示例：

  from django.contrib.auth import authenticate, login
  from django.shortcuts import render, redirect
  
  def login_view(request):
      if request.method == 'POST':
          username = request.POST.get('username')
          password = request.POST.get('password')
          user = authenticate(request, username=username, password=password)
          if user:
              login(request, user)
              return redirect('home')
          else:
              return render(request, 'login.html', {'error': '用户名或密码错误'})
      return render(request, 'login.html')
  

  注意：authenticate() 需传入 request（Django 1.10+），且表单字段名要和视图中获取的一致。

4. 确认表单字段匹配 #

检查 login.html 中表单 input 的 name 属性是否与视图字段对应：

• 示例表单：

  <form method="post">
      {% csrf_token %}
      <input type="text" name="username" placeholder="用户名">
      <input type="password" name="password" placeholder="密码">
      <button type="submit">登录</button>
  </form>
  

  若使用自定义表单（forms.py），需确保表单字段名正确，视图能正确读取数据。

5. 检查用户状态 #

确认用户的 is_active 字段为 True，若用户被禁用（is_active=False），即使密码正确也无法登录。

• 验证方式：

  user = User.objects.get(username='你的用户名')
  print(user.is_active)
  

  若为 False，执行 user.is_active = True; user.save() 启用用户。

6. 分析数据库查询日志 #

查看 PostgreSQL 查询日志，确认登录时是否正确查询用户表、传递参数是否正确：

• 正常查询示例：

  SELECT "auth_user"."id", "auth_user"."password", ... FROM "auth_user" WHERE "auth_user"."username" = '你的用户名' LIMIT 1;
  

  若无此查询，说明视图未触发用户查询；若查询返回用户但登录失败，大概率是密码哈希问题。

7. 自定义用户模型检查（若使用） #

若在 models.py 中自定义了用户模型，需满足：

• 继承 AbstractBaseUser 或 AbstractUser
• 设置 USERNAME_FIELD（如 username 或 email）
• 在 settings.py 中配置 AUTH_USER_MODEL = 'yourapp.YourUserModel'
• 确保 check_password() 方法正常工作

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