*************************** APPLICATION FAILED TO START *************************** Description: A component required a single bean, but 2 were found: - requestMappingHandlerMapping: defined by method 'requestMappingHandlerMapping' in class path resource [org/springframework/boot/autoconfigure/web/servlet/WebMvcAutoConfiguration$EnableWebMvcConfiguration.class] - controllerEndpointHandlerMapping: defined by method 'controllerEndpointHandlerMapping' in class path resource [org/springframework/boot/actuate/autoconfigure/endpoint/web/servlet/WebMvcEndpointManagementContextConfiguration.class] This may be due to missing parameter name information Action: Consider marking one of the beans as @Primary, updating the consumer to accept multiple beans, or using @Qualifier to identify the bean that should be consumed Ensure that your compiler is configured to use the '-parameters' flag. You may need to update both your build tool settings as well as your IDE.

<think>我们遇到了Spring Boot启动时出现的Bean冲突问题，具体错误信息是： "A component required a single bean but 2 were found: requestMappingHandlerMapping and controllerEndpointHandlerMapping" 这个错误通常发生在Spring Boot应用中，当存在多个相同类型的Bean，而Spring容器只能注入一个时。具体到这两个Bean： - `RequestMappingHandlerMapping`：Spring MVC中用于映射请求到控制器的标准组件。 - `ControllerEndpointHandlerMapping`：Spring Boot Actuator中用于处理执行器端点的组件。 冲突原因可能是同时引入了Spring MVC和Spring Boot Actuator，并且两者的自动配置产生了冲突。 ### 解决方案 #### 1. 排除冲突的自动配置类 在Spring Boot主配置类中排除`ControllerEndpointHandlerMapping`的自动配置： ```java @SpringBootApplication(exclude = { org.springframework.boot.actuate.autoconfigure.endpoint.web.servlet.ControllerEndpointAutoConfiguration.class }) public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` #### 2. 使用`@Primary`注解指定主Bean 如果不想完全排除Actuator端点，可以尝试在自定义的Web配置中声明主`HandlerMapping`： ```java @Configuration public class WebConfig { @Bean @Primary public RequestMappingHandlerMapping requestMappingHandlerMapping() { return new RequestMappingHandlerMapping(); } } ``` #### 3. 调整Actuator端点路径 在`application.properties`中修改Actuator端点的基础路径，避免与MVC控制器路径冲突： ```properties management.endpoints.web.base-path=/actuator ``` #### 4. 检查依赖版本兼容性 确保使用的Spring Boot版本中Actuator和Web模块兼容： ```xml <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.0</version> <!-- 推荐使用较新稳定版本 --> </parent> ``` ### 根本原因分析 | 组件 | 来源 | 作用 | |------|------|------| | `RequestMappingHandlerMapping` | `spring-webmvc` | 标准MVC控制器请求映射 | | `ControllerEndpointHandlerMapping` | `spring-boot-actuator` | 执行器端点专用映射 | 当应用同时需要Web功能和管理端点时，两个处理器映射Bean会同时注册到容器。Spring在注入时无法确定使用哪个Bean，导致冲突。 ### 验证步骤 1. 启动应用观察是否还有冲突错误 2. 访问`/actuator`端点验证功能是否正常 3. 测试普通控制器请求是否正常响应 > **注意**：方案1会完全禁用`ControllerEndpoint`，如果不需要自定义执行器端点则无影响；否则需采用方案2或3。 ### 相关问题 1. 如何区分Spring Boot中的`@ControllerEndpoint`和`@RestControllerEndpoint`？ 2. 在Spring Boot中如何自定义Actuator端点的安全配置？ 3. 如何解决Spring MVC与WebFlux同时引入时的冲突？ 4. Spring Boot中管理端点的路径配置有哪些注意事项？ 5. 如何为不同的Actuator端点设置不同的访问权限？</think>### 解决 Spring Boot 启动时 `requestMappingHandlerMapping` 和 `controllerEndpointHandlerMapping` 冲突 #### 🔍 问题原因分析 当 Spring Boot 同时引入 Web MVC 和 Actuator 依赖时，会出现两个 `HandlerMapping` 实现： 1. `RequestMappingHandlerMapping`：处理常规控制器请求（来自 `spring-boot-starter-web`） 2. `ControllerEndpointHandlerMapping`：处理 Actuator 端点请求（来自 `spring-boot-starter-actuator`） Spring 容器在自动装配时无法确定注入哪个 Bean，导致错误： ``` A component required a single bean but 2 were found ``` #### 🛠️ 解决方案 ##### 方案 1：排除冲突的自动配置（推荐） ```java @SpringBootApplication(exclude = { org.springframework.boot.actuate.autoconfigure.endpoint.web.servlet.WebMvcEndpointManagementContextConfiguration.class }) public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` > 此配置直接排除 Actuator 的 Web MVC 端点自动配置类[^4]。 ##### 方案 2：使用 `@Primary` 指定主 Bean ```java @Configuration public class HandlerMappingConfig { @Bean @Primary // 标记为主处理器映射 public RequestMappingHandlerMapping requestMappingHandlerMapping() { return new RequestMappingHandlerMapping(); } } ``` ##### 方案 3：调整 Actuator 配置 在 `application.properties` 中： ```properties # 禁用 Web 端点的 Actuator 映射 management.endpoints.web.exposure.include=info,health # 或完全禁用 Web 端点 management.endpoints.web.enabled=false ``` ##### 方案 4：精确控制 Bean 加载范围 ```java @Configuration @ConditionalOnWebApplication(type = Type.SERVLET) public class CustomEndpointConfig { @Bean @ConditionalOnMissingBean // 仅当缺失时创建 public ControllerEndpointHandlerMapping controllerEndpointHandlerMapping() { return new ControllerEndpointHandlerMapping(); } } ``` #### 📌 关键配置检查点 1. **依赖版本兼容性**： ```xml <!-- 确保版本一致 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <version>3.1.0</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> <version>3.1.0</version> </dependency> ``` 2. **组件扫描优化**： ```java @SpringBootApplication @ComponentScan(excludeFilters = @Filter( type = FilterType.ASSIGNABLE_TYPE, classes = ControllerEndpointHandlerMapping.class )) public class Application { ... } ``` #### ⚠️ 注意事项 1. **不要使用** `allow-bean-definition-overriding=true` 这会导致 Bean 定义被意外覆盖，引发更难排查的问题[^2] 2. Actuator 2.x 与 3.x 的 `HandlerMapping` 实现有差异，需检查版本： ```java // Actuator 2.x: ControllerEndpointHandlerMapping // Actuator 3.x: WebMvcEndpointHandlerMapping ``` > **最佳实践**：方案1的排除配置在大多数场景下可彻底解决问题，同时保留 Actuator 的核心监控功能[^4]。 --- ###