Spring Boot3：如何导入自动配置至另一配置并使条件注解生效？

场景回顾 #

我正在开发一个Spring Boot 3自动配置库，现有两个配置类：

@AutoConfiguration
@ConditionalOnWebApplication
// 其他自定义条件
public class TopLevelAutoConfiguration {}

@Configuration
@ConditionalOnBean(DataSource.class)
public class AdditionalConfiguration {}

TopLevelAutoConfiguration已注册到META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports中。我需要实现：仅当TopLevelAutoConfiguration生效（满足Web应用等条件），且容器中存在DataSource Bean时，AdditionalConfiguration才生效。要求不重复TopLevelAutoConfiguration的前置条件，也不将AdditionalConfiguration添加到imports文件。

可行解决方案 #

方案1：@Import + 配置顺序控制 #

在TopLevelAutoConfiguration中用@Import导入AdditionalConfiguration，同时添加@AutoConfigureAfter确保当前配置在数据源自动配置之后执行，这样@ConditionalOnBean能正确检测到已存在的DataSource Bean：

@AutoConfiguration
@ConditionalOnWebApplication
@AutoConfigureAfter(DataSourceAutoConfiguration.class)
@Import(AdditionalConfiguration.class)
public class TopLevelAutoConfiguration {}

AdditionalConfiguration保持原定义：

@Configuration
@ConditionalOnBean(DataSource.class)
public class AdditionalConfiguration {}

方案2：将AdditionalConfiguration标记为@AutoConfiguration #

把AdditionalConfiguration改为@AutoConfiguration注解（Spring Boot会自动处理其条件评估和执行顺序），再通过@Import导入：

@AutoConfiguration
@ConditionalOnBean(DataSource.class)
public class AdditionalConfiguration {}

@AutoConfiguration
@ConditionalOnWebApplication
@Import(AdditionalConfiguration.class)
public class TopLevelAutoConfiguration {}

这种方式下，Spring Boot会自动管理配置的执行顺序，无需手动指定@AutoConfigureAfter。

为何之前的尝试失败？ #

直接用@Import无法生效的核心原因是条件评估时机不对：

• 默认情况下，@ConditionalOnBean会在当前配置类解析阶段判断是否存在目标Bean。如果DataSource的自动配置类在TopLevelAutoConfiguration之后执行，此时DataSource的Bean定义还未注册，条件会被判定为不满足。
• 上述两种方案通过调整执行顺序或借助Spring Boot的自动配置排序逻辑，确保AdditionalConfiguration的条件评估在DataSource Bean定义完成后进行，从而正确触发条件。

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