Spring Boot 3中如何覆盖已定义的localeResolver Bean？

问题原因 #

Spring Boot 3里，DelegatingWebMvcConfiguration（继承自WebMvcConfigurationSupport）会自动注册默认的localeResolver Bean，而Spring默认禁用了Bean覆盖机制，导致自定义的同名Bean无法完成注册。

解决方案 #

1. 用@Primary注解指定优先使用自定义Bean #

在自定义的localeResolver Bean方法上添加@Primary注解，让Spring优先选用你的自定义实现：

@Bean
@Primary
public LocaleResolver localeResolver(MessageSourceProperties properties) {
    CookieLocaleResolver clr = new CookieLocaleResolver(properties.getCookieName());
    clr.setDefaultLocale(Locale.ENGLISH);
    return clr;
}

这种方式仅针对该Bean生效，不会全局修改Bean覆盖规则，是最稳妥的方案。

2. 全局开启Bean覆盖配置 #

如果需要允许全局范围内的Bean覆盖，可以在配置文件中添加以下配置：

• application.properties：

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

• application.yml：

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

⚠️ 注意：该配置会允许所有同名Bean互相覆盖，可能引发潜在的依赖冲突，需谨慎使用。

3. 通过WebMvcConfigurer配置结合自定义Bean #

实现WebMvcConfigurer接口，搭配自定义Bean使用：

@Configuration
public class CustomWebMvcConfig implements WebMvcConfigurer {

    @Bean
    @Primary
    public LocaleResolver customLocaleResolver(MessageSourceProperties properties) {
        CookieLocaleResolver clr = new CookieLocaleResolver(properties.getCookieName());
        clr.setDefaultLocale(Locale.ENGLISH);
        return clr;
    }
}

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