bcrypt.GenerateFromPassword生成的哈希必须转string存储,CompareHashAndPassword首参为数据库读出的完整哈希、次参为明文密码;cost推荐12且须校验4–31范围,明文长度需≤72且非空,数据库字段至少VARCHAR(255)。

bcrypt.GenerateFromPassword 生成的哈希必须存为 string,不是 []byte;bcrypt.CompareHashAndPassword 的第一个参数必须是数据库读出的完整哈希字符串,第二个才是用户提交的明文密码——错一个,登录就报 crypto/bcrypt: hashedPassword is not the hash of the given password。
注册时怎么调用 bcrypt.GenerateFromPassword
别直接用 bcrypt.DefaultCost(=10),它在并发稍高时容易拖垮服务。生产环境应显式指定 cost 并做范围校验:
-
cost必须在 4–31 范围内,否则函数会 panic,常见错误是传了 0、负数或从配置读取后没校验 - 推荐从
12起步:主流云服务器单次耗时约 150–250ms,QPS 可稳住 50+ - 明文密码必须先做非空和长度校验:
if len([]byte(pwd)) == 0 || len([]byte(pwd)) > 72,超长会被静默截断,导致哈希失效 - 调用后必须转成
string再存:hashedStr := string(hashed),别把[]byte直接塞进数据库字段
数据库字段怎么设才不被截断
bcrypt 哈希是固定长度 ASCII 字符串(如 "$2a$10$..."),标准长度为 60 字节,但字段设计不能只卡 60:
- MySQL 推荐用
VARCHAR(255)或TEXT,VARCHAR(60)是底线,但留余量防意外(比如未来算法升级) - PostgreSQL 更建议用
TEXT,避免长度限制引发的隐式截断 - GORM 模型中确保
Password字段有gorm:"size:255;not null"tag,且没被误标为json:"-"导致写入失败 - 入库前加一层格式预检(可选):
regexp.MustCompile(`^\$2[abxy]\$\d{2}\$[./A-Za-z0-9]{53}$`).MatchString(hashedStr)
登录时为什么 CompareHashAndPassword 总报 invalid hash
这个错误不是密码错了,而是你喂给它的第一个参数压根不是合法哈希——它连解析都失败了:
- 先打长度:
fmt.Println(len(user.Password)),不是 60 就立刻查源头(字段截断、ORM 自动 trim、JSON 反序列化去空格) - 查库后必须检查空值:
if len(user.Password) == 0,避免把空字符串传进去触发 panic - 比对前做
strings.TrimSpace(),防止前后空格破坏哈希结构(尤其当 ORM 或中间件自动处理时) - 绝对禁止在登录流程里再调一次
GenerateFromPassword——那是生成新哈希,跟库里存的老哈希永远不等 - 参数顺序不能颠倒:
CompareHashAndPassword([]byte(storedHash), []byte(plainPassword)),反着传直接报错
迁移老数据或调试时容易忽略的点
上线前或迁移旧系统时,最容易栽在“看起来能跑”的假象上:
- 如果数据库里存的是明文密码,不能“兼容”——必须走重哈希流程(让用户重设或后台批量触发),否则永远无法安全验证
- PHP 迁移来的
$2y$前缀哈希不被 Go 的golang.org/x/crypto/bcrypt支持,得提前转成$2a$或$2b$ - 日志里打印哈希时要脱敏:
log.Printf("hash len: %d, prefix: %s", len(hash), hash[:10]),别全量打出来 - 测试环境用
cost=4可以,但必须配独立配置开关,绝不能和生产混用
哈希值本身不带业务语义,它只认格式和字节。任何环节——入库、读取、传输、比对——只要有一个字节偏差,验证就彻底失效。问题往往不出在逻辑,而出在字段长度、空格、顺序、类型转换这些“小事”上。











