Spring Boot组合@Profile与自定义@Conditional时Bean未加载异常

核心原因 #

@Profile本质是Spring内置的条件注解，底层通过ProfileCondition实现判断逻辑。当同时使用@Profile和自定义@Conditional时，偶发的Bean注册失败，大概率是两个条件的判断时机不一致导致的：

• Spring处理@Profile的时机，和自定义Condition读取配置的时机可能存在微小差异，极端场景下（比如环境初始化的并发处理、配置加载的边缘情况），自定义Condition读取app.storage时可能还未获取到正确值，导致条件不满足，Bean未注册。
• 即使改用自定义Condition替代@Profile，只要是分开的两个条件判断，就可能存在同样的时机问题。

解决方案 #

1. 合并条件到同一个自定义Condition #

将Profile检查和配置属性检查合并到一个Condition中，保证判断逻辑的原子性，彻底避免时机差异：

public class MongoProfileAndStorageCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        // 检查激活的profile是否包含mongo
        boolean isMongoProfileActive = Arrays.stream(context.getEnvironment().getActiveProfiles())
                .anyMatch(profile -> "mongo".equalsIgnoreCase(profile));
        // 检查配置属性
        boolean isMongoStorage = "mongo".equalsIgnoreCase(context.getEnvironment().getProperty("app.storage"));
        // 两个条件都满足才返回true
        return isMongoProfileActive && isMongoStorage;
    }
}

修改Repository的注解：

@Repository
@Conditional(MongoProfileAndStorageCondition.class)
@Primary
public class MongoTreeRepository implements TreeRepository {
    // ...
}

2. 使用Spring Boot内置的@ConditionalOnProperty替代自定义Condition #

Spring Boot提供的@ConditionalOnProperty已经和环境、Profile的处理深度整合，能更好地避免时机问题。结合@Profile使用即可：

@Repository
@Profile("mongo")
@ConditionalOnProperty(name = "app.storage", havingValue = "mongo", matchIfMissing = false)
@Primary
public class MongoTreeRepository implements TreeRepository {
    // ...
}

这种方式不需要自定义Condition，利用Spring Boot原生注解的整合优势，减少时机冲突的可能。

关于@Primary的说明 #

@Primary不会影响条件判断逻辑，它的作用是当存在多个同类型TreeRepository Bean时，指定优先注入的Bean。条件判断是在Bean注册阶段完成的，而@Primary的逻辑是在Bean注入阶段生效，所以和本次偶发的Bean未注册问题无关。

内容的提问来源于stack exchange，提问作者JHONY ABRAHAM DE LEON PEREZ