Laravel项目管理员账号登录异常：邮箱识别但密码验证失败

我正在开发一个小型项目，使用数据库实现登录验证功能，已创建使用个人邮箱的管理员账号。系统包含以下标准错误提示：

• “未注册邮箱”
• “邮箱或密码错误”
• “缺少密码”

当前遇到的问题：

• 仅输入邮箱时，登录页面可正常识别该邮箱且无报错，说明数据库访问正常；
• 但输入我在Table Plus中手动录入的正确密码时，页面却提示“邮箱或密码错误”。

相关场景说明 #

1. 邮箱可正常被系统识别
2. 输入正确密码仍触发验证失败提示
3. 数据库中存在密码为test5的对应账号条目

排查与解决建议 #

1. 检查密码哈希处理逻辑 #

绝大多数登录系统都会对密码做哈希存储，如果你手动在数据库里存的是明文密码，但代码中登录验证时是将用户输入的密码哈希后再和数据库值比对，就会出现匹配失败。

• 查看登录逻辑代码，确认是否使用了bcrypt、Argon2或其他哈希算法；
• 如果代码用了哈希，需要把数据库里的明文密码替换成对应算法生成的哈希值，或者临时修改代码跳过哈希（仅用于测试）验证是否匹配。

2. 排查密码字段的格式问题 #

• 检查数据库中密码字段是否包含隐藏空格：在Table Plus中复制密码字段内容，直接粘贴到登录框中测试；
• 确认输入密码时是否有大小写错误：如果代码开启了大小写敏感验证，手动输入的大小写和数据库存储不一致也会失败。

3. 验证数据库字段的长度限制 #

如果使用哈希存储，比如bcrypt生成的哈希串长度约为60位，若数据库密码字段的类型是varchar(30)这类长度不足的类型，存储时会被截断，导致比对失败。

• 查看数据库表结构，确认密码字段的长度是否足够容纳哈希后的字符串。

4. 检查登录SQL查询语句 #

登录时的SQL查询逻辑错误也会导致匹配失败：

• 查看代码中执行的SQL语句，确认是否用AND同时匹配邮箱和密码，而非误写为OR；
• 将拼接好的SQL语句直接在数据库中执行，看是否能查询到对应的账号条目。

5. 排查字符编码一致性 #

若数据库的字符编码（如utf8mb4）与项目代码的字符编码不一致，可能导致密码字符串存储或读取时出现乱码，进而比对失败。

• 确认数据库表的字符编码设置，以及项目连接数据库时指定的编码参数。

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