Spring Security 4.0迁移至5.0报错：无id为null的PasswordEncoder映射

这个错误是Spring Security 5迁移时最常见的坑之一，原因很直白：Spring Security 5默认采用DelegatingPasswordEncoder作为密码编码器，它要求存储的密码必须携带「编码器标识前缀」（比如{bcrypt}、{noop}），但你从4.x版本迁移过来的密码大概率没有这个前缀，导致系统找不到对应的编码器，于是抛出了id为null的异常。

下面给你几种实用的解决办法，按需选择：

1. 给现有密码添加编码器前缀（长期推荐方案） #

这是最贴合Spring Security 5设计规范的做法：

• 如果是明文存储的密码（仅建议测试环境使用），在密码前加上{noop}，比如原密码123456改为{noop}123456
• 如果是BCrypt加密的密码，前缀加{bcrypt}，比如原加密串$2a$10$...改为{bcrypt}$2a$10$...
• 其他加密算法同理，对应前缀参考Spring Security官方支持的编码器标识

这种方式能让系统清晰识别每个密码的加密方式，后续维护也更省心。

2. 配置全局默认密码编码器（快速兼容方案） #

如果你暂时不想修改数据库里的旧密码，可以在Spring配置类中指定默认编码器，让系统用它来验证无前缀的密码：

示例1：兼容明文密码（仅测试/临时场景用，生产绝对禁用） #

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Bean
    public PasswordEncoder passwordEncoder() {
        // NoOp是明文编码器，生产环境用这个等于裸奔！
        return NoOpPasswordEncoder.getInstance();
    }

    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.inMemoryAuthentication()
            .withUser("admin")
            .password("admin123") // 无需加前缀，默认用NoOp验证
            .roles("ADMIN");
    }
}

示例2：使用安全的BCrypt编码器（生产推荐） #

如果你的旧密码都是BCrypt加密的，直接配置默认编码器为BCrypt即可：

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

3. 自定义DelegatingPasswordEncoder映射（混合加密场景方案） #

如果系统里同时存在多种加密方式的密码（比如部分明文、部分BCrypt），可以自定义编码器映射，并指定默认编码器来兼容无前缀的旧密码：

@Bean
public PasswordEncoder passwordEncoder() {
    // 设置无前缀密码默认使用的编码器标识
    String defaultEncoderId = "bcrypt";
    // 配置多种编码器的映射关系
    Map<String, PasswordEncoder> encoderMap = new HashMap<>();
    encoderMap.put(defaultEncoderId, new BCryptPasswordEncoder());
    encoderMap.put("noop", NoOpPasswordEncoder.getInstance());
    encoderMap.put("sha256", new StandardPasswordEncoder());

    // 创建DelegatingPasswordEncoder，无前缀密码自动用默认编码器验证
    return new DelegatingPasswordEncoder(defaultEncoderId, encoderMap);
}

关键提醒 #

• 生产环境严禁使用NoOpPasswordEncoder，务必选用BCrypt、Argon2这类自带加盐机制的安全哈希算法，能有效抵御彩虹表攻击。
• 长期来看，建议逐步将所有旧密码迁移到带前缀的格式，或者统一加密方式，避免后续维护出现混乱。

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