Spring Boot 4下如何在Maven父项目中禁用MessageSourceAutoConfiguration？

1. 父Starter中排除自动配置的正确方式 #

父Starter无法通过spring.autoconfigure.exclude配置项直接排除自动配置——因为Spring Boot会优先加载应用级（子项目）的配置，父Starter的配置会被覆盖。正确做法是在父Starter的自动配置类上使用@EnableAutoConfiguration(exclude = MessageSourceAutoConfiguration.class)，同时确保该配置类被Spring的自动配置机制扫描到：

@Configuration
@EnableAutoConfiguration(exclude = MessageSourceAutoConfiguration.class)
public class CustomMessageSourceAutoConfig {
    @Bean
    public MessageSource customMessageSource() {
        ResourceBundleMessageSource source = new ResourceBundleMessageSource();
        source.setBasenames("messages/custom");
        source.setDefaultEncoding("UTF-8");
        // 其他自定义配置逻辑
        return source;
    }
}

同时需要在父Starter的META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件中注册该配置类，文件内容为配置类的全限定名：

com.yourpackage.CustomMessageSourceAutoConfig

2. 让@AutoConfigureBefore生效的必要前提 #

如果坚持使用@AutoConfigureBefore(MessageSourceAutoConfiguration.class)，需满足两个核心条件：

• 自定义配置类必须是标准自动配置类：即搭配@Configuration和@Conditional系列注解，且通过Spring Boot自动配置机制加载，普通@Configuration类的优先级注解不会生效。
• 给自定义MessageSource Bean添加@Primary注解：Spring Boot 4对Bean优先级的判定更严格，即使配置类优先加载，若无@Primary标记，仍可能被自动配置的Bean覆盖：

@Bean
@Primary
public MessageSource customMessageSource() {
    // 自定义配置逻辑
}

3. 排查Spring Boot 4的自动配置变更 #

Spring Boot 4对MessageSource自动配置做了细节调整，比如优化了MessageSourceProperties的绑定逻辑、调整了自动配置的触发条件。可以通过启动时添加--debug参数查看自动配置报告，确认自定义Bean的加载状态和MessageSourceAutoConfiguration的排除情况：

java -jar your-app.jar --debug

在日志的Positive matches和Negative matches板块，检查自定义配置是否被正常加载，且MessageSourceAutoConfiguration处于排除状态。

4. 避免父Starter与子项目的配置冲突 #

若子项目中存在MessageSource相关配置，会覆盖父Starter的设置。需确保：

• 子项目不重复定义MessageSource Bean
• 子项目的application.properties/application.yml中不配置spring.messages.*系列参数，这类参数会触发自动配置Bean的生效

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