复制AWS RDS数据库后Django用户认证失败问题排查

一、相同密码创建用户哈希不同是正常行为 #

Django使用的pbkdf2_sha256哈希算法会为每个密码生成随机盐值，最终的哈希字符串包含盐值、迭代次数等参数。因此即使是相同密码，每次生成的哈希结果也会不同，但验证时Django会从哈希字符串中提取盐值重新计算并对比，完全不影响登录验证的正确性。

二、认证失败原因排查步骤 #

• 确认数据库连接正确性
  验证Django实际连接的是新数据库new_db而非原库。在Django Shell中执行以下命令查看当前数据库名：

  from django.db import connection
  print(connection.settings_dict['NAME'])
  

• 检查用户状态字段
  自定义CustomUser模型通常包含is_active这类控制用户登录权限的字段，需确认新库中该字段值与原库一致（应为True）。执行SQL查询对比：

  select username, is_active from defapp_customuser where id=1;
  

  若存在其他自定义状态字段（如is_enabled），也需一并检查。

• 验证user_can_authenticate方法结果
  继承的ModelBackend类的user_can_authenticate方法默认检查is_active为True，若你重写了该方法，或模型有额外限制，可能导致验证失败。可在认证代码中临时添加日志输出：

  logger.info(f"[auth] User is_active: {user.is_active}")
  logger.info(f"[auth] user_can_authenticate result: {self.user_can_authenticate(user)}")
  

• 排查数据库编码与字符串一致性
  若原库与新库的字符集编码不一致，可能导致密码哈希字符串存在隐形字符差异。执行以下命令对比编码：

  show server_encoding;
  

  再通过MD5哈希值确认密码字符串完全一致：

  select username, md5(password) from defapp_customuser where id=1;
  

  原库与新库的MD5值必须完全相同。

• 检查密码哈希算法配置
  确认settings.py中的PASSWORD_HASHERS配置与原环境一致，需包含django.contrib.auth.hashers.PBKDF2PasswordHasher（默认已包含，但若被修改可能导致验证失败）。示例默认配置：

  PASSWORD_HASHERS = [
      'django.contrib.auth.hashers.PBKDF2PasswordHasher',
      'django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher',
      'django.contrib.auth.hashers.Argon2PasswordHasher',
      'django.contrib.auth.hashers.BCryptSHA256PasswordHasher',
  ]
  

• 手动测试密码验证
  在Django Shell中直接测试新库用户的密码验证：

  from defapp.models import CustomUser
  user = CustomUser.objects.get(id=1)
  print(user.check_password('你的原始密码'))  # 查看返回True还是False
  

  若返回False，可尝试手动重置哈希值后再测试：

  user.password = 'pbkdf2_sha256$600000$bZ2UvAJc7cwJMFyk63hlLO$h8/Y2lFZTkwbghyvM/rliyBxwQxF2dMMSqk5tfFqqyo='
  user.save()
  print(user.check_password('你的原始密码'))
  

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