Spring Boot 3.0.0外部包Bean名称冲突问题求解

你遇到的是两个依赖都定义了同名objectMapperProvider Bean导致的冲突，以下是几种可行的解决办法：

1. 允许Bean定义覆盖（快速临时方案） #

在application.properties或application.yml中添加配置，允许Spring覆盖同名Bean：

spring.main.allow-bean-definition-overriding=true

或者YAML格式：

spring:
  main:
    allow-bean-definition-overriding: true

注意：这个方案会让Spring自动选择最后加载的Bean覆盖之前的，可能存在逻辑不一致的风险，建议仅作为临时调试用，生产环境谨慎使用。

2. 排除冲突的自动配置类 #

通过排除其中一个依赖的自动配置类，避免其注册objectMapperProvider Bean：

• 排除GraphQL的自动配置类：
  在启动类上添加排除注解：

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

  或者在application.properties中配置：

  spring.autoconfigure.exclude=graphql.kickstart.autoconfigure.web.servlet.GraphQLWebAutoConfiguration
  

• 若更依赖GraphQL的默认配置，也可以排除SpringDoc的自动配置类：

  @SpringBootApplication(exclude = SpringDocConfiguration.class)
  

  配置文件方式：

  spring.autoconfigure.exclude=org.springdoc.core.configuration.SpringDocConfiguration
  

注意：排除自动配置类后，可能需要手动补充该依赖中其他必要的Bean配置，确保功能正常。

3. 自定义Primary Bean覆盖冲突 #

自己定义一个objectMapperProvider Bean，并添加@Primary注解，让Spring优先使用这个自定义Bean，忽略依赖中的同名Bean：

import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Primary;
import org.springframework.stereotype.Component;

@Component
public class CustomObjectMapperConfig {

    @Primary
    @Bean(name = "objectMapperProvider")
    public ObjectMapper customObjectMapperProvider() {
        ObjectMapper objectMapper = new ObjectMapper();
        // 这里可以根据需求配置ObjectMapper，比如复制其中一个依赖的配置逻辑
        // 例如添加日期格式化、序列化规则等
        return objectMapper;
    }
}

这个方案更可控，能按需配置ObjectMapper，适合生产环境使用。

4. 升级依赖版本 #

检查两个依赖的新版本是否已经修复了Bean名称冲突问题：

• springdoc-openapi-starter-webmvc-ui：查看是否有高于2.0.2的版本
• graphql-spring-boot-starter：查看是否有高于15.0.0的版本
  部分新版本可能会修改Bean名称或调整自动配置逻辑，避免冲突。

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