You need to enable JavaScript to run this app. Spring Boot中@ConditionalOnProperty无法加载对应Bean问题求助
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot中@ConditionalOnProperty无法加载对应Bean问题求助

问题原因

你遇到的Bean未找到异常核心由以下两个常见问题导致:

1. 配置类内Bean方法重载冲突

你在DataSourceConfiguration中定义了两个名字都是myRepository的@Bean方法,二者属于Kotlin合法的方法重载,但Spring默认使用方法名作为Bean的唯一标识,会将两个方法识别为同一个Bean的重复定义,即使加了互斥的条件注解,也会出现Bean定义覆盖问题,最终导致符合条件的Bean没有被正常注册到上下文。

2. Kotlin默认final限制(未引入Spring Kotlin插件时触发)

Kotlin的类和方法默认是final修饰的,如果你没有引入Spring官方的Kotlin插件(会自动给@Configuration等注解的类和方法加open修饰),Spring无法代理配置类,也会导致@Bean方法不生效。


解决方案

第一步:修改Bean方法名避免重载

将两个MyRepository的Bean方法改为不同的方法名,因为两个条件互斥,上下文永远只会存在一个MyRepository类型的Bean,不需要额外指定Bean名即可按类型正常注入:

@Configuration
class DataSourceConfiguration {

    @Bean
    @ConditionalOnProperty(
        prefix = "datasource",
        name = ["mock"],
        havingValue = "false",
        matchIfMissing = true
    )
    fun httpMyRepository(httpClient: HttpClient): MyRepository =
        HttpRepository(httpClient)

    @Bean
    @ConditionalOnProperty(
        prefix = "datasource",
        name = ["mock"],
        havingValue = "true"
    )
    fun inMemoryMyRepository(): MyRepository = InMemoryRepository()
}

第二步(可选,未引入Spring Kotlin插件时需要):给配置类和方法加open修饰

@Configuration
open class DataSourceConfiguration {

    @Bean
    @ConditionalOnProperty(
        prefix = "datasource",
        name = ["mock"],
        havingValue = "false",
        matchIfMissing = true
    )
    open fun httpMyRepository(httpClient: HttpClient): MyRepository =
        HttpRepository(httpClient)

    @Bean
    @ConditionalOnProperty(
        prefix = "datasource",
        name = ["mock"],
        havingValue = "true"
    )
    open fun inMemoryMyRepository(): MyRepository = InMemoryRepository()
}

第三步(可选,避免扫描路径问题):强制导入数据源配置

如果两个配置类不在启动类的扫描路径下,可以直接在服务配置类上添加@Import注解强制导入数据源配置:

@Configuration
@Import(DataSourceConfiguration::class)
class MyServiceConfiguration {
    // 顺带修正之前的方法名拼写错误(mySerivce -> myService,不影响注入但会影响Bean名称)
    @Bean
    fun myService(myRepository: MyRepository) = MyService(myRepository)
}

内容的提问来源于stack exchange,提问作者Adam Żarniewicz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 08:36:03