Spring Boot已定义PasswordEncoder Bean仍提示找不到BCryptPasswordEncoder

问题根源 #

你在SecurityConfig中注册的是PasswordEncoder接口类型的Bean，但UserService构造方法依赖的是具体实现类BCryptPasswordEncoder。Spring依赖注入时会严格按照参数声明的类型查找匹配Bean，即便BCryptPasswordEncoder实现了PasswordEncoder，注册为父接口类型的Bean也无法被直接识别为子类型的Bean。

两种解决方式 #

方式一：修改SecurityConfig的Bean返回类型 #

直接将Bean的返回类型改为BCryptPasswordEncoder，确保注册的Bean类型与依赖类型一致：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

@Configuration
public class SecurityConfig {

    @Bean
    public BCryptPasswordEncoder passwordEncoder() { // 将返回类型改为BCryptPasswordEncoder
        return new BCryptPasswordEncoder();
    }

    // 其他Security配置代码...
}

方式二：给UserService的依赖添加@Qualifier注解 #

如果不想修改SecurityConfig，可以在UserService的构造方法参数上添加@Qualifier注解，指定要注入的Bean名称（默认Bean名称为配置类中方法名passwordEncoder）：

import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    private final BCryptPasswordEncoder passwordEncoder;

    // 添加@Qualifier指定Bean名称
    public UserService(@Qualifier("passwordEncoder") BCryptPasswordEncoder passwordEncoder) {
        this.passwordEncoder = passwordEncoder;
    }

    // 其他业务方法...
}

额外建议 #

实际开发中更推荐方式一，因为BCryptPasswordEncoder就是你实际使用的实现类，直接注册为具体类型的Bean可以避免类型匹配问题，同时代码更直观。

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