使用@ConditionalOnProperty与@Bean时@Autowired注入错误实现的问题

你遇到的这个问题，核心原因是Spring容器里同时存在多个IceProvider类型的Bean，而@Autowired在没有明确指定的情况下，默认选择了最先被注册的那个实例。具体拆解一下：

为什么会出现这个矛盾？ #

你给LocalIceProvider和TwilioIceProvider都加了@Component注解，这会触发Spring的组件扫描机制——在应用启动时，不管你配置的ice.provider是什么值，这两个类都会被自动注册为Bean。

而你在Controller里定义的@Bean方法，是试图根据配置条件再创建一个对应的IceProvider实例。这就导致：
当配置ice.provider=twilio时，容器里实际有两个IceProvider Bean：

1. 来自@Component的localIceProvider（LocalIceProvider实例，因为@Component没有条件限制，始终被注册）
2. 来自@Bean的twilioIceProvider（TwilioIceProvider实例，满足条件被创建）

这时候@Autowired IceProvider iceProvider会怎么选？Spring在遇到多个同类型Bean且没有@Qualifier或@Primary指定时，会优先匹配Bean名称与变量名一致的实例；如果没有匹配的，就会选择容器中最先被注册的那个Bean——而LocalIceProvider因为是组件扫描先发现的，所以被优先注入了。

解决方案（二选一即可） #

方案1：移除实现类上的@Component，用@Configuration+@Bean控制

既然你已经用@ConditionalOnProperty配合@Bean来控制Bean的创建，就不需要让组件扫描自动注册它们了：

1. 给两个实现类去掉@Component注解：

// 去掉@Component
public class LocalIceProvider implements IceProvider {
    // 你的业务逻辑
}

// 去掉@Component
public class TwilioIceProvider implements IceProvider {
    // 你的业务逻辑
}

2. 把@Bean方法移到专门的@Configuration类里（别放在Controller里，这是Spring最佳实践）：

@Configuration
public class IceProviderConfig {

    // 当配置为local或未配置时，注册LocalIceProvider
    @Bean
    @ConditionalOnProperty(
        name = "ice.provider",
        havingValue = "local",
        matchIfMissing = true
    )
    public IceProvider iceProvider() {
        return new LocalIceProvider();
    }

    // 当配置为twilio时，注册TwilioIceProvider（会覆盖上面的Bean）
    @Bean
    @ConditionalOnProperty(
        name = "ice.provider",
        havingValue = "twilio"
    )
    public IceProvider iceProvider() {
        return new TwilioIceProvider();
    }
}

这样容器里永远只会有一个IceProvider Bean，@Autowired就能正确注入符合配置的实例。

方案2：给@Component添加条件注解，去掉@Bean方法

如果你更倾向于用组件扫描，直接给两个实现类加上@ConditionalOnProperty即可：

@Component
@ConditionalOnProperty(
    name = "ice.provider",
    havingValue = "local",
    matchIfMissing = true
)
public class LocalIceProvider implements IceProvider {
    // 你的业务逻辑
}

@Component
@ConditionalOnProperty(
    name = "ice.provider",
    havingValue = "twilio"
)
public class TwilioIceProvider implements IceProvider {
    // 你的业务逻辑
}

这时候Spring会根据配置只注册符合条件的那个Bean，不会出现冲突。

额外小提醒 #

别在Controller里定义@Bean方法！Controller的职责是处理HTTP请求，Bean的定义应该放在@Configuration类中，这能让代码结构更清晰，也符合Spring的设计理念。

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