Spring Boot启动失败：registrationController依赖注入异常及循环引用求助

• 你之前推测的UserRepo无匹配Bean的判断和日志给出的链路不匹配，本次报错的明确根因是名为encoder的Bean创建过程中存在Spring无法自动解析的循环依赖，并非仓储接口的注入缺失。
• 实际的依赖传递链路为：
  1. 容器初始化registrationController时，发现类中需要注入passwordEncoder类型依赖
  2. 顺着依赖查找路径，定位到提供该Bean的webSecurityConfig配置类，开始初始化该Bean
  3. 初始化webSecurityConfig时，发现类中userDetailsService字段需要对应实现类的Bean
  4. 容器开始初始化MyUserDetailsService实现类，过程中提前触发了对encoder Bean的引用，形成webSecurityConfig → userDetailsService → encoder → webSecurityConfig的闭环，超出Spring默认三级缓存的解析能力，直接抛出初始化失败异常。

• 场景1：WebSecurityConfig配置类内部的方法调用形成硬依赖环
  典型错误写法：

  @Configuration
  public class WebSecurityConfig {
      // 类中注入了MyUserDetailsService
      @Autowired
      private MyUserDetailsService userDetailsService;
  
      @Bean
      public PasswordEncoder passwordEncoder() {
          return new BCryptPasswordEncoder();
      }
  
      @Override
      protected void configure(AuthenticationManagerBuilder auth) throws Exception {
          // 直接在方法内调用passwordEncoder()，加上userDetailsService字段注入，形成硬依赖环
          auth.userDetailsService(userDetailsService).passwordEncoder(passwordEncoder());
      }
  }
  

  修复方式：不要在配置类内部通过方法调用的形式引用其他需要依赖本配置类的Bean，将PasswordEncoder的使用逻辑下沉到对应业务类，或者调整注入位置为字段注入，避免硬编码的方法调用形成的依赖闭环。
• 场景2：MyUserDetailsService实现类反向依赖WebSecurityConfig中定义的Bean
  典型错误写法：

  @Service
  public class MyUserDetailsService implements UserDetailsService {
      // 构造方法直接注入来自WebSecurityConfig的PasswordEncoder
      public MyUserDetailsService(PasswordEncoder encoder) {
          this.encoder = encoder;
      }
  }
  

  此时依赖链会形成：WebSecurityConfig需要注入MyUserDetailsService → MyUserDetailsService需要注入WebSecurityConfig中定义的PasswordEncoder → PasswordEncoder的初始化依赖WebSecurityConfig的上下文，完全形成无打破点的闭环。
  修复方式：
  • 在循环链的某一环节的注入位置添加@Lazy注解，延迟非必要依赖的初始化时机，打破环的闭合。比如给MyUserDetailsService中的PasswordEncoder注入位置加@Lazy，或者给WebSecurityConfig中的userDetailsService字段加@Lazy。
  • 将PasswordEncoder的Bean定义从WebSecurityConfig中抽离到独立的通用配置类，让PasswordEncoder的初始化完全不依赖安全配置类的上下文，从根源上切断循环链。
• 场景3：Spring Security 6.x 版本的初始化规则适配问题
  新版本Spring Security要求PasswordEncoder必须作为顶层独立Bean暴露，不能嵌套在安全配置类的内部方法中创建，否则极易和userDetailsService的初始化顺序产生冲突触发循环引用，需要按照版本要求调整Bean的暴露方式。

• 你提到的UserRepo接口无匹配Bean的可能性，可以补充校验：确认接口所在包是否被Spring Data JPA的仓储扫描路径覆盖，不过这个问题不会触发本次日志中明确标注的循环依赖报错。
• 排查时优先打开完整日志中标记为The dependencies that form the cycle are的段落，按照日志明确列出的循环节点定位，不需要靠猜测缩小排查范围。

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