Spring Boot多拦截器引发NoUniqueBeanDefinitionException问题求解

以下是几种在保留依赖的前提下解决Bean冲突的方案，可根据实际场景选择：

方案1：标记依赖的Bean为@Primary #

如果依赖的InterceptorConfiguration需要注入自身的MetricsInterceptor，可以在应用中手动注册该Bean并标记为@Primary，让Spring优先选择它注入到依赖的配置类中：

@Configuration
public class DependencyBeanOverrideConfig {
    @Bean
    @Primary
    public MetricsInterceptor metricsInterceptor() {
        return new MetricsInterceptor();
    }
}

• 优势：无需修改依赖源码，自身的WebConfig因为使用了@Qualifier("metricsInterceptorInternal")，依然会注入自定义的拦截器，不受影响。
• 注意：确保依赖的MetricsInterceptor无特殊构造参数，否则需要在@Bean方法中正确初始化。

方案2：手动创建依赖的配置类并指定注入Bean #

如果可以覆盖依赖的InterceptorConfiguration自动注册行为，可手动创建该Bean并明确注入依赖的MetricsInterceptor：

1. 先排除依赖中InterceptorConfiguration的自动注册：

@SpringBootApplication(exclude = InterceptorConfiguration.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 手动创建配置类并注入指定Bean：

@Configuration
public class CustomInterceptorConfiguration {
    @Bean
    public InterceptorConfiguration interceptorConfiguration(MetricsInterceptor metricsInterceptor) {
        InterceptorConfiguration config = new InterceptorConfiguration();
        config.setRequestResponseContextInterceptor(metricsInterceptor);
        // 若还有其他依赖注入，需补充对应的setter调用
        return config;
    }
}

• 优势：完全控制依赖配置类的Bean创建，避免自动注入的歧义。
• 注意：需要了解InterceptorConfiguration的完整初始化逻辑，确保所有依赖都正确注入。

方案3：排除依赖的MetricsInterceptor（仅当依赖不需要它时） #

如果依赖的其他功能可以正常工作，不需要其MetricsInterceptor，可以排除该Bean的自动扫描：

@SpringBootApplication
@ComponentScan(excludeFilters = {
    @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, classes = MetricsInterceptor.class)
})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

• 注意：需确认依赖的InterceptorConfiguration不强制依赖MetricsInterceptor，否则会导致新的注入失败错误。

方案4：使用@Qualifier配合Bean名称匹配（若能修改依赖源码） #

如果有权限修改依赖的源码，直接在InterceptorConfiguration的setter方法参数上添加@Qualifier指定Bean名称：

@Configuration
public class InterceptorConfiguration implements WebMvcConfigurer {
    private HandlerInterceptorAdapter metricsInterceptor;

    public void setRequestResponseContextInterceptor(@Qualifier("metricsInterceptor") HandlerInterceptorAdapter metricsInterceptor) {
        this.metricsInterceptor = metricsInterceptor;
    }
}

• 优势：从根源解决歧义，最规范的方式。
• 局限：仅适用于可修改依赖源码的场景。

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