为何自定义manage.py命令创建的Django用户无法完成认证？

嘿，我之前也碰到过一模一样的问题！你这种情况大概率是密码没有被正确哈希处理导致的，毕竟Django的认证系统依赖它特有的密码哈希机制，咱们一步步来排查解决：

最常见的问题：密码未正确哈希 #

Django的用户模型（包括你继承自基础User的自定义模型）不会直接存储明文密码，必须通过set_password()方法生成符合要求的哈希值。如果你的自定义命令里直接把密码赋值给password字段，数据库里存的就是原始密码字符串，而认证时Django会用哈希算法去匹配，自然会失败。

错误示例： #

# 直接赋值password字段，会导致密码未哈希
user = CustomUser.objects.create(
    username=username,
    email=email,
    password=password,  # 这里是错误的！
    is_superuser=True,
    is_staff=True
)

正确写法： #

方法1：使用set_password()

先创建用户（不设置password），再调用set_password()哈希密码并保存：

user = CustomUser.objects.create(
    username=username,
    email=email,
    is_superuser=True,
    is_staff=True
)
user.set_password(password)  # 关键：用这个方法哈希密码
user.save()

方法2：使用create_user()管理器方法

如果你的自定义用户模型的Manager类实现了create_user方法（Django推荐的做法），可以直接用这个方法创建，它会自动处理密码哈希：

user = CustomUser.objects.create_user(
    username=username,
    email=email,
    password=password
)
# 再设置超级用户和staff属性
user.is_superuser = True
user.is_staff = True
user.save()

其他需要排查的点 #

• 检查AUTH_USER_MODEL配置：确保你的settings.py里已经指定了自定义用户模型，比如：

  AUTH_USER_MODEL = 'your_app_name.CustomUser'
  

  如果没设置这个，Django会默认使用内置的User模型，那你自定义模型创建的用户自然无法被认证系统识别。

• 验证认证后端：如果自定义了认证后端，要确保它能正确处理你的自定义用户模型。一般来说，默认的ModelBackend是支持自定义用户模型的，只要AUTH_USER_MODEL配置正确，这一步大概率没问题。

快速测试方法 #

你可以在Django shell里手动测试认证，确认问题所在：

python manage.py shell

然后执行：

from django.contrib.auth import authenticate
user = authenticate(username='你的用户名', password='你的密码')
print(user)  # 返回None表示认证失败，返回用户对象表示成功

如果修改代码后重新创建用户，再测试能返回用户对象，那问题就解决啦！

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