PHP 8.3 password_verify 验证失败一直返回 false 怎么排查

现象

注册接口用 password_hash 生成密码写入用户表,登录时 password_verify 一直返回 false。把同一个明文重新 hash 一次再验证却是 true,数据库里取出的值看起来也是以 $2y$ 开头的正常哈希。

原因

最常见是字段长度不够。bCrypt 的结果固定 60 个字符,字段如果是 varchar(50),入库时被静默截断,验证自然失败。其次是入库前对密码做了 trim、htmlspecialchars 或二次 hash;注册和登录用了不同的算法参数;读取时取错字段,拿到的是空值或别的列。

解决步骤

第一步,确认哈希本身是否完整。在写入前打印长度和算法信息,确认是 60 个字符的 bcrypt,而不是被截断或被别的函数处理过。

$hash = password_hash($pwd, PASSWORD_DEFAULT);
var_dump(strlen($hash));
var_dump(password_get_info($hash)['algoName']);
var_dump(password_verify($pwd, $hash));

第二步,改表结构和写入逻辑。字段改成 varchar(255),写入时直接存原始哈希,不做任何转义;读取后先判断长度是否等于 60,再调用 password_verify,避免把空值送进去。

ALTER TABLE users MODIFY password VARCHAR(255) NOT NULL;
SELECT id, LENGTH(password) FROM users LIMIT 5;

第三步,处理历史数据。已经被截断的账号无法恢复原密码,只能走重置流程;登录成功后用 password_needs_rehash 判断是否需要按新参数重新生成,逐步把旧哈希替换掉。

验证

新注册账号能正常登录,password_verify 返回 true,password_get_info 显示 bcrypt,数据库里长度统一为 60 或 255 字段内的完整值。

小结

验证失败先怀疑存储环节,长度截断和重复处理最常见。字段留足、原样存取,再谈算法参数。

您可以还会对下面的文章感兴趣: