继承配置类时遭遇同名Bean注册错误的技术问询

报错原因 #

1. 父类配置独立加载+子类重复注册：外部库的WebConfigParent本身已被Spring识别为配置类并加载，会注册名为mappingJackson2HttpMessageConverter的Bean；而你编写的WebConfigChild继承父类后，若也标记了@Configuration，Spring会将父类的所有@Bean方法纳入子类配置的处理范围——哪怕你重写方法并指定了新Bean名称，父类作为独立配置类依然会注册原始的同名Bean，最终引发冲突。
2. 重写时Bean名称未彻底覆盖：如果重写方法时仅添加@Bean(name = "anotherMapper")，但方法名仍为mappingJackson2HttpMessageConverter，在Spring配置类代理模式下，可能会默认以方法名注册Bean，同时生成你指定的anotherMapper，反而出现两个Bean的冲突（或者你误以为重写后父类的Bean会失效，但实际并未生效）。

安全解决办法 #

方法1：排除父类配置的自动加载 #

直接通过@SpringBootApplication或@ComponentScan的exclude属性，将外部库的WebConfigParent排除在Spring扫描范围外，让父类的@Bean不会被注册，完全由子类配置生效：

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

这种方式最彻底，无冲突风险，前提是你不依赖父类的其他Bean。

方法2：用@Primary指定优先Bean #

如果无法排除父类配置（比如外部库其他功能依赖父类配置），可以在子类重写的@Bean方法上添加@Primary注解，让Spring注入MappingJackson2HttpMessageConverter时优先选择子类的Bean，父类的Bean依然存在但不会引发冲突：

@Configuration
public class WebConfigChild extends WebConfigParent {
    @Primary
    @Override
    public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter() {
        // 复用父类逻辑并添加自定义配置，比如设置自定义ObjectMapper
        MappingJackson2HttpMessageConverter converter = super.mappingJackson2HttpMessageConverter();
        converter.setObjectMapper(customObjectMapper());
        return converter;
    }

    private ObjectMapper customObjectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 配置序列化、反序列化规则，比如日期格式、空值处理等
        return mapper;
    }
}

方法3：不继承父类，直接自定义替换 #

放弃继承WebConfigParent，通过实现WebMvcConfigurer配置消息转换器，直接替换默认的MappingJackson2HttpMessageConverter：

@Configuration
public class WebConfigChild implements WebMvcConfigurer {
    @Bean
    public MappingJackson2HttpMessageConverter customMappingJackson2HttpMessageConverter() {
        MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
        // 自定义配置逻辑
        converter.setObjectMapper(customObjectMapper());
        return converter;
    }

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        // 移除容器中原有的MappingJackson2HttpMessageConverter
        converters.removeIf(converter -> converter instanceof MappingJackson2HttpMessageConverter);
        // 添加自定义的Converter
        converters.add(customMappingJackson2HttpMessageConverter());
    }

    private ObjectMapper customObjectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 自定义序列化规则
        return mapper;
    }
}

这种方式完全绕过父类配置逻辑，不会有继承带来的冲突问题，是比较推荐的做法。

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