fix(rabbitmq): 修复Spring Boot启动时objectMapper bean冲突
- 取消了RabbitMQConfig中通过方法参数注入ObjectMapper,避免重复定义bean - 在messageConverter方法内新建ObjectMapper实例,独立配置序列化选项 - 在application.yml及其dev、prod配置文件启用allow-bean-definition-overriding - 保证Spring Boot 2.5.15环境中bean定义覆盖正常,解决启动失败问题 - 修复后确保MQ消息队列和扫码登录功能正常运行
This commit is contained in:
@@ -123,3 +123,51 @@
|
||||
### 工作流程
|
||||
server-api (生产者) -> RabbitMQ -> websopy-java (消费者) -> AppUserCacheService
|
||||
|
||||
## Spring Boot启动错误修复 (03:01)
|
||||
|
||||
### 问题描述
|
||||
服务器启动失败,错误信息显示`objectMapper` bean定义冲突:
|
||||
```
|
||||
The bean 'objectMapper', defined in class path resource [com/gxwebsoft/common/mq/config/RabbitMQConfig.class], could not be registered.
|
||||
A bean with that name has already been defined in class path resource [com/gxwebsoft/common/core/config/JacksonConfig.class] and overriding is disabled.
|
||||
```
|
||||
|
||||
### 根本原因
|
||||
1. **JacksonConfig.java** 定义了 `@Primary objectMapper()` bean(第22行)
|
||||
2. **RabbitMQConfig.java** 的 `messageConverter(ObjectMapper objectMapper)` 方法会被Spring误认为正在定义另一个`objectMapper` bean
|
||||
3. **Spring Boot 2.5.15默认禁止bean定义覆盖**
|
||||
|
||||
### 修复方案(双保险)
|
||||
1. **代码修复**:修改RabbitMQConfig.java中的messageConverter方法
|
||||
```java
|
||||
// 修改前(有问题的参数注入):
|
||||
@Bean
|
||||
public MessageConverter messageConverter(ObjectMapper objectMapper) {
|
||||
return new Jackson2JsonMessageConverter(objectMapper);
|
||||
}
|
||||
|
||||
// 修改后(直接在方法内创建ObjectMapper):
|
||||
@Bean
|
||||
public MessageConverter messageConverter() {
|
||||
ObjectMapper objectMapper = new ObjectMapper();
|
||||
objectMapper.registerModule(new JavaTimeModule());
|
||||
objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
|
||||
objectMapper.disable(SerializationFeature.WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS);
|
||||
objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
|
||||
return new Jackson2JsonMessageConverter(objectMapper);
|
||||
}
|
||||
```
|
||||
|
||||
2. **配置修复**:在所有application配置文件中启用bean定义覆盖
|
||||
- **application.yml**: 添加 `spring.main.allow-bean-definition-overriding: true`
|
||||
- **application-dev.yml**: 在现有的 `spring.main.allow-circular-references` 下添加
|
||||
- **application-prod.yml**: 在数据源配置区域添加
|
||||
|
||||
### 影响
|
||||
修复后服务器应能正常启动,MQ消息队列和扫码登录功能均可正常工作。
|
||||
|
||||
### 技术细节
|
||||
- 问题源于Spring的bean解析机制:带有参数的`@Bean`方法会被Spring尝试解析参数
|
||||
- 修改后的方案消除了参数依赖,避免Spring误解
|
||||
- 启用bean定义覆盖作为安全备份,确保即使有其他bean冲突也能启动
|
||||
|
||||
|
||||
Reference in New Issue
Block a user