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:
2026-04-07 03:05:34 +08:00
parent 04ec9659b0
commit 3e7f34fa0d
6 changed files with 63 additions and 7 deletions

View File

@@ -13,5 +13,5 @@
}
]
},
"lastUpdated": 1775498241052
"lastUpdated": 1775501968801
}

View File

@@ -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冲突也能启动