SpringBoot 2.0.1.RELEASE中BCryptPasswordEncoder报错：编码密码非BCrypt格式

我之前在Spring Boot 2.x项目里也踩过这个坑，结合你的场景，给你梳理几个核心排查方向和解决办法：

1. 先确认密码存储格式是否符合BCrypt规范 #

BCrypt生成的加密串有严格的格式要求：

• 必须以$2a$、$2b$或$2y$开头
• 总长度固定为60位

如果你的数据库里存的是明文密码、其他加密算法（比如MD5/SHA）的结果，或者格式不匹配的字符串，就会触发这个报错。

快速验证方法：手动生成一个合法的BCrypt串测试，比如写个简单的main方法：

public static void main(String[] args) {
    BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
    // 替换成你的测试密码
    System.out.println(encoder.encode("test123"));
}

把输出的60位串替换到数据库中，再测试登录，如果不再报错，说明是密码存储格式的问题。

2. 检查Security配置中是否正确配置了BCryptPasswordEncoder #

Spring Security不会自动帮你使用BCrypt，必须显式配置：

第一步：注册BCryptPasswordEncoder Bean #

在你的SecurityConfig类中添加这个Bean定义：

@Bean
public PasswordEncoder passwordEncoder() {
    return new BCryptPasswordEncoder();
}

第二步：在认证逻辑中绑定密码编码器 #

重写configure(AuthenticationManagerBuilder auth)方法，指定使用这个编码器：

@Override
protected void configure(AuthenticationManagerBuilder auth) throws Exception {
    // 替换成你的UserDetailsService实现类
    auth.userDetailsService(customUserDetailsService)
        .passwordEncoder(passwordEncoder());
}

如果你的项目用了自定义的AuthenticationProvider，也要确保在provider中使用同一个PasswordEncoder实例。

3. 排查环境差异导致的逻辑冲突 #

看你的配置里有判断dev环境的逻辑，要注意：

• 是否dev环境下密码是明文存储，而生产环境用了BCrypt？
• 是否不同环境的配置文件中，密码处理的逻辑不一致？

比如如果dev环境下你直接用了明文密码，但Security配置里还是绑定了BCrypt编码器，就会触发报错。这种情况可以给dev环境单独配置一个NoOpPasswordEncoder（仅用于开发，生产绝对不能用）：

@Bean
@Profile("dev")
public PasswordEncoder devPasswordEncoder() {
    return NoOpPasswordEncoder.getInstance();
}

@Bean
@Profile("!dev")
public PasswordEncoder prodPasswordEncoder() {
    return new BCryptPasswordEncoder();
}

4. 检查BCrypt版本兼容性问题 #

Spring Boot 2.0.1对应的Spring Security版本，BCryptPasswordEncoder默认使用$2a$版本的加密串。如果你的加密串是PHP常用的$2y$格式，虽然BCrypt本身兼容，但旧版本的编码器可能识别有问题。可以尝试显式指定版本：

@Bean
public PasswordEncoder passwordEncoder() {
    return new BCryptPasswordEncoder(BCryptVersion.$2Y);
}

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