Spring环境动态加载Bean：@Conditional引发Bean冲突的解决方案求助

你遇到的核心问题是**@Conditional的条件逻辑没做到真正互斥**，或者条件判断依赖了未初始化的资源，导致Spring初始化时同时创建了两个Bean。下面是具体的排查方向和解决方案：

一、先排查条件类的核心问题 #

1. 验证条件逻辑是否真的互斥
   写个简单的单元测试，模拟目标环境参数（部署区域、Profile、配置属性），分别调用两个条件类的matches方法，确认任何场景下都只有一个返回true：

   @Test
   void testConditionMutuallyExclusive() {
       // 模拟目标环境的Environment
       MockEnvironment env = new MockEnvironment();
       env.setProperty("app.deployment.region", "specific-region");
       env.setActiveProfiles("prod");
       env.setProperty("app.feature.do-thing.enabled", "true");
       
       ConditionContext context = new ConditionContext() {
           @Override
           public Environment getEnvironment() { return env; }
           @Override
           public BeanDefinitionRegistry getRegistry() { return null; }
           @Override
           public ConfigurableListableBeanFactory getBeanFactory() { return null; }
           @Override
           public ResourceLoader getResourceLoader() { return null; }
           @Override
           public ClassLoader getClassLoader() { return null; }
       };
       
       boolean doThingMatch = new DoThingCondition().matches(context, null);
       boolean noopMatch = new NoopDoThingCondition().matches(context, null);
       
       // 验证：两个结果不能同时为true
       assert !(doThingMatch && noopMatch);
   }
   

   如果测试发现存在同时满足的场景，说明条件逻辑有漏洞（比如边界值判断错误、配置属性读取逻辑错误），直接修正即可。

2. 检查条件类是否依赖未初始化资源
   @Conditional的判断在Bean初始化之前执行，所以条件类里不能用@Autowired注入其他Bean，必须通过ConditionContext.getEnvironment()获取配置、Profile等信息，否则会因依赖未初始化导致判断错误。

二、可靠的实现方案 #

方案1：让两个条件绝对互斥 #

直接把Noop的条件设置为核心功能条件的取反，从根源上避免同时满足的情况：

// 核心功能的条件类
public class DoThingCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        Environment env = context.getEnvironment();
        // 组合判断：部署区域+Profile+配置属性
        String region = env.getProperty("app.deployment.region");
        boolean hasValidProfile = env.acceptsProfiles(Profiles.of("prod", "staging"));
        boolean featureEnabled = env.getProperty("app.feature.do-thing.enabled", Boolean.class, false);
        
        return "specific-region".equals(region) && hasValidProfile && featureEnabled;
    }
}

// Noop的条件类直接取反核心条件
public class NoopDoThingCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        return !new DoThingCondition().matches(context, metadata);
    }
}

给两个Service标记对应条件：

@Service
@Conditional(DoThingCondition.class)
public class DoThingService implements DoThingInterface {
    // 业务逻辑实现
}

@Service
@Conditional(NoopDoThingCondition.class)
public class NoopService implements DoThingInterface {
    // 空实现或默认逻辑
}

方案2：用@ConditionalOnMissingBean兜底 #

如果不想写两个条件类，可以先注册核心功能Bean，当核心Bean不存在时再注册NoopBean：

@Service
@Conditional(DoThingCondition.class)
public class DoThingService implements DoThingInterface {
    // 业务逻辑实现
}

@Service
@ConditionalOnMissingBean(DoThingInterface.class)
public class NoopService implements DoThingInterface {
    // 空实现或默认逻辑
}

这种方式更简洁，只要核心Bean的条件判断正确，NoopBean只会在核心Bean未被创建时初始化，自然保证了Bean的唯一性。

三、额外排查点 #

• 检查是否有其他配置类通过@Bean手动注册了这两个Service，如果有，要把条件判断加到@Bean方法上，而不是只加在类上。
• 确认@ComponentScan的范围没有意外包含这两个类的重复定义（比如多模块下的重复类）。

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