Django登录时报“Invalid salt”错误，该如何解决？

错误本质 #

这个错误是因为bcrypt无法识别你传入的哈希值（即email_result.pin）中的盐格式，核心问题出在注册阶段的密码哈希流程，或者数据库存储/读取时的格式损坏。

具体解决步骤 #

1. 修正注册时的pin哈希逻辑 #

确保注册时用bcrypt正确生成哈希值，而非明文存储或错误哈希。正确的注册代码示例：

import bcrypt

# 注册时处理pin
pin = request.data.get('pin')
# 生成盐并完成哈希
hashed_pin = bcrypt.hashpw(pin.encode('utf-8'), bcrypt.gensalt())
# 若存字符串格式，需转码；若存bytes，用BinaryField
user = Users(email=email, pin=hashed_pin.decode('utf-8'))
user.save()

如果注册时直接存明文pin、用了其他哈希算法，bcrypt必然无法识别盐格式。

2. 检查数据库pin字段的配置 #

bcrypt生成的哈希值固定为60字符（默认设置），所以Users模型中pin字段必须设置足够长度：

# 模型字段示例
pin = models.CharField(max_length=128)  # 留冗余避免截断

若字段长度不足，哈希值会被截断，导致bcrypt无法解析盐格式。

3. 统一登录时的编码处理 #

如果注册时将哈希值转成字符串存储，登录时要把数据库读取的字符串转回bytes：

# 对应注册时的decode操作，登录时重新encode
if bcrypt.checkpw(pin.encode("utf-8"), email_result.pin.encode('utf-8')):
    # 后续登录逻辑

若注册时直接存bytes类型，模型字段需用BinaryField()，避免格式转换错误。

4. 验证数据库中的pin值 #

直接查看数据库Users表的pin字段，正常bcrypt哈希值以$2b$或$2a$开头，例如：$2b$12$EixZaY3sLxpHqWSuperLongHashString。如果值是明文、空值或格式异常，直接定位到注册环节的问题。

5. 统一编码格式 #

确保注册和登录时的pin编码都是utf-8，不要混用其他编码。

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