Spring Boot登录注册模块Bean循环依赖问题求助

你的循环依赖根源在于：

• SecurityConfiguration 构造器注入 UserService（即UserServiceImpl）
• UserServiceImpl 构造器注入 PasswordEncoder，而PasswordEncoder的Bean定义在SecurityConfiguration类中

Spring创建这些Bean时会陷入闭环：创建SecurityConfiguration需要UserService，创建UserService需要PasswordEncoder，创建PasswordEncoder需要先初始化SecurityConfiguration实例，这种构造器层级的循环即使开启allow-circular-references也无法打破。

以下是两种可行的解决方案：

方案一：将PasswordEncoder Bean移至独立配置类 #

这是最干净的解决方式，剥离密码编码器的Bean定义，彻底消除依赖闭环：

1. 新建独立配置类PasswordConfig：

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

2. 修改SecurityConfiguration，移除内部的passwordEncoder()方法：

@Configuration
@EnableWebSecurity
public class SecurityConfiguration {
    private final UserService userService;

    public SecurityConfiguration(UserService userService) {
        this.userService = userService;
    }

    // 保留你的其他安全配置代码，比如AuthenticationManager、SecurityFilterChain等
}

3. UserServiceImpl代码无需修改，保持原构造器注入即可：

@Service
public class UserServiceImpl implements UserService {
    private final UserRepository userRepository;
    private final PasswordEncoder passwordEncoder;

    @Autowired
    public UserServiceImpl(UserRepository userRepository, PasswordEncoder passwordEncoder) {
        this.userRepository = userRepository;
        this.passwordEncoder = passwordEncoder;
    }

    // 业务方法实现
}

调整后Spring会先创建独立的PasswordEncoder Bean，再创建UserServiceImpl，最后创建SecurityConfiguration，彻底打破循环。

方案二：延迟注入PasswordEncoder #

如果不想移动Bean定义，可在UserServiceImpl中对PasswordEncoder使用@Lazy注解，延迟其初始化时机：

@Service
public class UserServiceImpl implements UserService {
    private final UserRepository userRepository;
    private final PasswordEncoder passwordEncoder;

    @Autowired
    public UserServiceImpl(UserRepository userRepository, @Lazy PasswordEncoder passwordEncoder) {
        this.userRepository = userRepository;
        this.passwordEncoder = passwordEncoder;
    }

    // 业务方法实现
}

这种方式会让Spring先创建SecurityConfiguration（此时PasswordEncoder为代理对象），再创建UserServiceImpl，直到第一次调用passwordEncoder时才完成其初始化，从而绕过循环。

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