AuthenticationManager做JWT认证时Bad credentials错误排查修复
BadCredentialsException 问题定位与修复实操 核心排查方向(按问题出现概率从高到低排序)
- 1. 密码加密存储与校验规则不匹配(占同类问题80%以上)
这是JWT认证接入时最高发的问题:注册流程存库的密码格式,和Security框架鉴权时的校验逻辑不一致。
错误场景示例:注册时直接把用户输入的明文密码存入数据库,但是WebSecurityConfig中配置的全局PasswordEncoder是BCrypt实现,鉴权时会拿数据库存储的明文,和前端传入密码经BCrypt哈希后的结果做比对,必然匹配失败。
验证方法:直接查询数据库中测试用户的密码字段,正常BCrypt加密的密码是$2a$/$2b$开头的40位以上的哈希字符串,如果看到的是明文、MD5等短格式字符串,直接修复注册逻辑:
额外检查点:确保注册流程和鉴权流程使用的是同一个// 修复:入库前必须走统一的PasswordEncoder加密 user.setPassword(passwordEncoder.encode(原始明文密码));PasswordEncoderBean,避免出现“注册用NoOp加密、鉴权用BCrypt校验”的规则错配。 - 2. UserDetails加载逻辑字段错配
检查自定义UsersDetailService的loadUserByUsername实现:- 确认查询数据库时的匹配字段:有没有把手机号、邮箱字段误当作用户名查询,导致加载的用户和请求传入的用户名不是同一个主体
- 确认
UserDetails对象的密码字段:必须赋值为数据库存储的加密后的密文,不能错把前端传入的明文密码、其他业务字段值塞到这个字段里 - 确认账号状态:如果代码里默认把用户设为
disabled,很多全局异常处理器会把DisabledException统一包装成BadCredentialsException返回,需要单独排查
- 3. 多格式请求绑定导致凭据被篡改
因为/authenticate接口同时支持表单、多部分、JSON三种入参格式,非常容易出现参数绑定错误:- JSON入参场景:检查
AuthRequest实体的字段命名,确保和前端传参的key完全匹配,避免Jackson反序列化时因为字段不匹配拿到null值(比如前端传username/password,后端字段因为命名规则不匹配拿到null) - 表单/多部分入参场景:检查全局的字符编码、参数转码过滤器,有没有把密码里的特殊字符(如
!、@、#)做了转义/截断,导致和注册时的原始密码不一致 - 打debug断点核对:在调用
authenticationManager.authenticate()之前,打印构造的UsernamePasswordAuthenticationToken对象里的用户名、密码值,确认和Postman里传入的参数完全一致,没有错传成其他字段值。
- JSON入参场景:检查
- 4. 残留逻辑干扰鉴权流程
虽然已经注释了自定义JwtRequestFilter的实现和过滤链配置,仍需要排查:- 被注释的过滤器类有没有因为被标记了
@Component,被Spring容器扫描生成代理,提前在其他执行链路篡改了SecurityContext里的凭据对象 - 有没有其他全局拦截器、AOP切面在请求到达鉴权逻辑前,修改了请求参数里的密码字段
- 被注释的过滤器类有没有因为被标记了
快速验证技巧:直接在断点中,用数据库存储的加密密码,手动调用
passwordEncoder.matches(Postman传入的明文密码, 数据库密文),如果返回true,说明编码逻辑没问题,顺着往前排查参数传递环节即可;如果返回false,直接修复注册时的密码存储逻辑。
内容的提问来源于stack exchange,提问作者axels18m
相关产品推荐
相关产品推荐

