Spring Boot 3 + Java 21 JWT实现遇Bean循环依赖问题求助

问题根源明确 #

这个错误不是服务类多次初始化导致，是典型的Spring Bean循环依赖问题——容器创建Bean时形成了闭环依赖链：
JwtAuthenticationFilter → UserServiceImpl → LoginServiceImpl → SecurityConfiguration → JwtAuthenticationFilter
原示例无此问题，大概率是你重命名CredentialManager或调整注入逻辑时，不小心让下游服务（如LoginServiceImpl）直接/间接依赖了SecurityConfiguration，或者SecurityConfiguration中的Bean被反向注入到了下游服务，形成了闭环。

解决方案 #

方案1：打破循环依赖链（推荐） #

定位循环的关键节点，重构依赖关系：

• 检查LoginServiceImpl的依赖：如果它依赖了SecurityConfiguration，但实际只需要其中的某个Bean（比如CredentialManager），直接注入目标Bean而非整个配置类。
  示例调整：

  // 错误写法：依赖整个SecurityConfiguration
  @Service
  public class LoginServiceImpl {
      private final SecurityConfiguration securityConfig;
      public LoginServiceImpl(SecurityConfiguration securityConfig) {
          this.securityConfig = securityConfig;
      }
  }
  
  // 正确写法：直接依赖所需的CredentialManager
  @Service
  public class LoginServiceImpl {
      private final CredentialManager credentialManager;
      public LoginServiceImpl(CredentialManager credentialManager) {
          this.credentialManager = credentialManager;
      }
  }
  

• 梳理JwtAuthenticationFilter的注入路径：确保它仅被SecurityConfiguration配置使用，下游业务服务（UserServiceImpl/LoginServiceImpl）不要依赖它。

方案2：临时开启循环依赖允许（不推荐长期使用） #

如果暂时无法定位循环节点，可通过配置允许Spring处理循环依赖，但这只是治标不治本，会增加后续维护复杂度：

• 在application.properties中添加：

  spring.main.allow-circular-references=true
  

• 或在启动类中配置：

  @SpringBootApplication
  public class YourApplication {
      public static void main(String[] args) {
          new SpringApplicationBuilder(YourApplication.class)
                  .allowCircularReferences(true)
                  .run(args);
      }
  }
  

方案3：用@Lazy延迟加载打破闭环 #

在循环依赖的任意节点添加@Lazy注解，延迟Bean的初始化时机：
示例：在JwtAuthenticationFilter注入UserServiceImpl时添加延迟加载

@Component
public class JwtAuthenticationFilter extends OncePerRequestFilter {
    private final UserServiceImpl userService;
    public JwtAuthenticationFilter(@Lazy UserServiceImpl userService) {
        this.userService = userService;
    }
}

额外排查建议 #

• 检查所有类的构造函数/@Autowired注入，移除不必要的依赖。
• 对比原示例的依赖关系，确认重命名CredentialManager后是否意外修改了注入路径。

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