PBKDF2密码验证返回false，已用random_bytes替代mcrypt_create_iv

常见故障原因 #

• 常量定义不匹配
  你生成的哈希结构为算法:迭代次数:盐值:哈希值共4段，需确保相关索引常量定义正确：

// 必须和哈希段数对应
define('HASH_SECTIONS', 4);
// 各字段索引从0开始计数
define('HASH_ALGORITHM_INDEX', 0);
define('HASH_ITERATION_INDEX', 1);
define('HASH_SALT_INDEX', 2);
define('HASH_PBKDF2_INDEX', 3);

同时要保证生成哈希和校验哈希时，PBKDF2_HASH_ALGORITHM、PBKDF2_ITERATIONS、PBKDF2_SALT_BYTE_SIZE、PBKDF2_HASH_BYTE_SIZE这几个全局常量的值完全一致，若中途修改过常量值，旧哈希会全部校验失败。

• 哈希存储异常
  数据库存储哈希的字段长度不足，或者存储时做了转义处理（如将base64中的+、/、=等特殊字符转义），会导致哈希拆分、解码错误，建议将存储字段设为varchar(255)，存储时不要做任何额外转义操作。
• 密码编码不一致
  生成哈希和校验时输入的密码编码不同（如存在多余空格、UTF-8 BOM头、前后换行符），也会导致校验失败。

排查步骤 #

1. 本地直连测试：跳过数据库存储，直接将a_pbkdf2_create_hash()输出的哈希值传入a_pbkdf2_validate_password()校验，如果直连测试正常，则故障点在存储环节。
2. 打印校验参数：在a_pbkdf2_validate_password函数中$params = explode(':', $correct_hash);后临时添加打印代码，确认拆分后的4段参数和生成哈希时的参数完全一致。
3. 确认random_bytes兼容性：PHP 7.0及以上版本已内置random_bytes函数，替代mcrypt_create_iv的方案完全正确，不会导致校验失败。

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