Spring Boot定义同名同类型Bean未报错且忽略s2 Bean是否为预期行为？

问题场景 #

我尝试通过@Bean注解配置类，根据特定属性注册两个同类型、同名的Bean中的一个，并注入到其他Bean中，但遇到不符合预期的行为：

场景1：无条件的同名Bean #

定义两个同名同类型的Bean，Spring未抛出冲突异常，直接忽略其中一个：

@Bean("bean-1")
// 基于属性的特定条件
fun s1() = "1"

@Bean("bean-1")
// 基于属性的特定条件
fun s2() = "2"

@Bean
fun result(
    @Qualifier("bean-1") b: String
): Any? {
    return null
}

场景2：带条件注解的同名Bean #

添加条件注解后，s2的Bean始终不会被创建，即使@ConditionalOnProperty的条件满足（matchIfMissing = true）：

@Bean("bean-1")
@ConditionalOnMissingBean(name = ["bean-1"])
fun s1() = "1"

@Bean("bean-1")
@ConditionalOnProperty(name = ["some_property"], matchIfMissing = true)
fun s2() = "2"

@Bean
fun result(
    @Qualifier("bean-1") b: String
): Any? {
    return null
}

请问这是Spring Boot的预期行为吗？

回答 #

这是Spring Boot的预期行为，核心原因在于Spring容器对同名Bean的注册逻辑：

1. 同名Bean的注册规则 #

当Spring容器遇到多个同名的Bean定义时，默认会保留第一个被加载的Bean定义，忽略后续的同名定义，不会抛出Bean冲突异常。这种设计是为了兼容多配置源（如XML、注解、自动配置）的场景，允许先加载的Bean定义优先生效。

2. 场景2的具体原因 #

在第二个场景中：

• 容器先处理s1的Bean定义，此时容器中还没有名为bean-1的Bean，@ConditionalOnMissingBean条件满足，因此s1被成功注册。
• 后续处理s2的Bean定义时，容器中已经存在bean-1（来自s1），Spring直接忽略这个同名的Bean定义，不会再检查@ConditionalOnProperty的条件是否满足。

3. 正确实现方式 #

要实现“根据属性二选一注册Bean”的需求，需确保两个Bean的条件互斥，或调整Bean定义的顺序：

方案1：互斥的属性条件

让两个Bean的@ConditionalOnProperty条件互斥，确保同一时间只有一个条件满足：

@Bean("bean-1")
@ConditionalOnProperty(name = ["some_property"], havingValue = "false", matchIfMissing = true)
fun s1() = "1"

@Bean("bean-1")
@ConditionalOnProperty(name = ["some_property"], havingValue = "true")
fun s2() = "2"

@Bean
fun result(
    @Qualifier("bean-1") b: String
): Any? {
    return null
}

方案2：调整顺序+缺失Bean条件

将属性匹配的Bean放在前面，后续用@ConditionalOnMissingBean兜底：

// 先检查属性，满足则注册s2
@Bean("bean-1")
@ConditionalOnProperty(name = ["some_property"], havingValue = "true")
fun s2() = "2"

// 如果s2未注册（属性不满足），则注册s1
@Bean("bean-1")
@ConditionalOnMissingBean(name = ["bean-1"])
fun s1() = "1"

@Bean
fun result(
    @Qualifier("bean-1") b: String
): Any? {
    return null
}

内容的提问来源于stack exchange，提问作者Роман Григорьев