Laravel Hash::make与Hash::check随机失效，需多次修改密码才验证通过

1. 检查数据库密码存储字段长度 #

Laravel默认使用bcrypt算法生成密码哈希，标准bcrypt哈希固定长度为60个字符。如果你的usu_per_pin字段设置的长度小于60（比如varchar(50)），哈希值会被截断，直接导致校验随机失败。
修复方案：将usu_per_pin字段长度调整为至少varchar(60)，如果考虑后续切换到argon2等其他哈希算法，建议直接设置为varchar(255)。

2. 校验密码原始字符串一致性 #

排查哈希生成和校验两个环节的原始密码是否完全匹配：

• 生成哈希前打印$pin的原始长度、十六进制编码，校验前打印$credentials['password']的原始长度、十六进制编码，对比两者是否完全一致
• 检查Windows程序传递数据时，是否带入了额外的空白字符（比如换行符、回车符、BOM头），或者存在编码转换问题
• 确认生成哈希和校验哈希的代码中，没有对原始密码做多余的trim、大小写转换等非预期处理

3. 检查User模型字段修改器 #

确认你的User模型中是否定义了usu_per_pin字段的修改器（即setUsuPerPinAttribute方法），如果修改器中已经自动做了Hash::make处理，你在业务代码中再次调用Hash::make就会导致密码被二次哈希，出现校验随机失败的问题。
修复方案二选一：

• 去掉业务代码中的Hash::make逻辑，直接传入明文密码，由模型修改器自动完成哈希
• 删除模型中对应字段的修改器，由业务代码自行处理哈希逻辑

4. 排查哈希存储时的转义问题 #

确认Windows程序更新用户密码、Laravel保存哈希时，是否正确处理了哈希值中的特殊字符：

• 不要直接拼接SQL语句存储哈希，必须使用参数绑定，避免哈希中的$符号被识别为SQL变量或者被错误转义
• 二次确认存储到数据库的哈希值是否和Hash::make输出的完全一致，不存在多余的反斜杠、空格等额外字符

5. 临时调试快速定位 #

可以分别在哈希生成、校验环节增加日志，快速定位问题节点：
哈希生成环节增加即时校验：

//Make hash 
$hashed = Hash::make($pin);
// 即时校验生成的哈希是否正常
if (!Hash::check($pin, $hashed)) {
    Log::error('哈希生成异常', ['pin' => $pin, 'hashed' => $hashed]);
}

登录校验环节增加参数日志：

$credentials = $request->validate([
    'email' => ['required'],
    'password' => ['required'],
]);
$user = User::where('usu_per_login', $credentials['email'])->first();
$checkResult = Hash::check($credentials['password'], $user->usu_per_pin);
Log::debug('校验参数详情', [
    'input_password' => $credentials['password'],
    'stored_hash' => $user->usu_per_pin,
    'check_result' => $checkResult
]);

通过日志对比即可快速定位是生成、存储还是校验环节的问题。

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