2025-06-24 16:06:02.186 ERROR 20780 --- [ main] o.s.b.d.LoggingFailureAnalysisReporter : *************************** APPLICATION FAILED TO START *************************** Description: The bean 'jwtAuthFilter', defined in class path resource [com/example/health/drug/security/UserDetailsServiceImpl.class], could not be registered. A bean with that name has already been defined in file [D:\study\计算机工程课设\medicine_management\target\classes\com\example\health\drug\security\JwtAuthFilter.class] and overriding is disabled. Action: Consider renaming one of the beans or enabling overriding by setting spring.main.allow-bean-definition-overriding=true

### 解决 Spring Boot 中 JwtAuthFilter Bean 重复定义导致的注册失败问题 在 Spring Boot 应用中，当多个配置类或组件尝试注册同名的 `JwtAuthFilter` Bean 时，可能会出现 Bean 定义冲突（BeanDefinitionOverrideException），从而导致应用启动失败。此类问题通常出现在模块化项目中，不同模块各自定义了相同类型的 Bean，或者通过自动扫描机制引入了重复的 Bean 定义。 为了避免这种情况，可以采取以下几种策略： #### 使用 `@Primary` 注解指定首选 Bean 若存在多个同类型的 Bean，可以通过在期望优先使用的 Bean 上添加 `@Primary` 注解来明确指定其为首选 Bean。例如： ```java @Bean @Primary public JwtAuthFilter jwtAuthFilter(JwtUtils jwtUtils, UserDetailsService userDetailsService) { return new JwtAuthFilter(jwtUtils, userDetailsService); } ``` 该方式适用于仅需一个实例的场景，并能确保 Spring 在注入过程中使用正确的 Bean 实例[^1]。 #### 显式排除重复 Bean 的自动注册 如果某个 `JwtAuthFilter` 是通过组件扫描（Component Scan）被注册的，可以在配置类中通过 `@ComponentScan` 的 `excludeFilters` 属性将其排除，避免与手动定义的 Bean 冲突。例如： ```java @Configuration @ComponentScan(basePackages = "com.example.app", excludeFilters = { @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, classes = JwtAuthFilter.class) }) public class AppConfig { } ``` 此方法可有效防止因自动扫描引入的重复 Bean 定义问题。 #### 使用不同的 Bean 名称避免冲突 Spring 允许通过 `@Bean` 方法的名称区分不同的 Bean。若需要多个 `JwtAuthFilter` 实例，应为每个 Bean 指定不同的名称并显式声明其用途。例如： ```java @Bean("jwtAuthFilterV1") public JwtAuthFilter jwtAuthFilterV1(JwtUtils jwtUtils, UserDetailsService userDetailsService) { return new JwtAuthFilter(jwtUtils, userDetailsService); } @Bean("jwtAuthFilterV2") public JwtAuthFilter jwtAuthFilterV2(JwtUtils jwtUtils, UserDetailsServiceImpl userDetailsService) { return new JwtAuthFilter(jwtUtils, userDetailsService); } ``` 这种方式适合需要根据上下文选择不同实现的场景。 #### 在 Security 配置中直接使用构造器创建实例 若不希望将 `JwtAuthFilter` 声明为全局 Bean，也可以在安全配置类的 `configure` 方法中直接通过构造函数创建实例。这样可以绕过 Bean 定义冲突的问题： ```java @Override protected void configure(HttpSecurity http) throws Exception { http.addFilterBefore(new JwtAuthFilter(jwtUtils, userDetailsService), UsernamePasswordAuthenticationFilter.class); } ``` 此方法适用于只需要在一处使用该过滤器的情况，且可避免不必要的 Bean 注册。 --- ###