@ConfigurationProperties默认值不被@ConditionalOnProperty识别求助

我有一个标注了@ConfigurationProperties的record类MyappProperties，包含多个配置项，其中内部record类ConfigForJob的writerImplementation字段通过@DefaultValue设置了默认值“MongoTemplate”。我希望通过@ConditionalOnProperty根据该配置值条件化创建Tasklet类型Bean，但默认值未被Spring识别，启动时提示找不到对应Bean，手动配置该属性则正常运行，求助解决此问题。

相关代码示例：

@ConfigurationProperties(prefix = "myapp", ignoreUnknownFields = false)
public record MyappProperties(
    // 其他配置项
    @DefaultValue ConfigForJob configForJob
) {
    // 其他逻辑
    public record ConfigForJob (
        @DefaultValue("MongoTemplate") String writerImplementation
    ) {
        // 内部逻辑
    }
}

@Bean
@Autowired
@ConditionalOnProperty(name = "myapp.config-for-job.writer-implementation", havingValue = "MongoTemplate")
public Tasklet mongoTemplateTasklet(MongoTemplate mongoTemplate) {
    // Bean实现逻辑
}

@Bean
@Autowired
@ConditionalOnProperty(name = "myapp.config-for-job.writer-implementation", havingValue = "MongoRepository")
public Tasklet mongoRepositoryTasklet(MongoRepository mongoRepository) {
    // Bean实现逻辑
}

核心原因 #

@DefaultValue是@ConfigurationProperties专属的属性填充注解，仅作用于属性类内部的默认值赋值，但Spring的@ConditionalOnProperty只会读取Spring环境（Environment）中的配置项——未显式配置的属性不会自动进入环境，哪怕你在属性类里设置了@DefaultValue。

解决办法 #

方法1：给@ConditionalOnProperty添加默认匹配规则 #

直接修改条件注解的matchIfMissing属性，当配置未显式设置时，默认匹配指定条件，和属性类的默认值保持一致：

@Bean
@ConditionalOnProperty(
    name = "myapp.config-for-job.writer-implementation",
    havingValue = "MongoTemplate",
    matchIfMissing = true // 关键：配置未设置时默认触发此Bean的创建
)
public Tasklet mongoTemplateTasklet(MongoTemplate mongoTemplate) {
    // 实现逻辑
}

@Bean
@ConditionalOnProperty(
    name = "myapp.config-for-job.writer-implementation",
    havingValue = "MongoRepository"
)
public Tasklet mongoRepositoryTasklet(MongoRepository mongoRepository) {
    // 实现逻辑
}

方法2：用@ConditionalOnExpression读取属性类的默认值 #

如果希望直接依赖MyappProperties中已经绑定的默认值，可以通过表达式读取容器中的属性类实例：

// 先确保MyappProperties已被Spring注册，比如添加@EnableConfigurationProperties(MyappProperties.class)
@Bean
@ConditionalOnExpression("#{@myappProperties.configForJob().writerImplementation().equals('MongoTemplate')}")
public Tasklet mongoTemplateTasklet(MongoTemplate mongoTemplate) {
    // 实现逻辑
}

@Bean
@ConditionalOnExpression("#{@myappProperties.configForJob().writerImplementation().equals('MongoRepository')}")
public Tasklet mongoRepositoryTasklet(MongoRepository mongoRepository) {
    // 实现逻辑
}

关键注意事项 #

• 必须确保MyappProperties被Spring正确加载：可以在配置类上添加@EnableConfigurationProperties(MyappProperties.class)，或者直接给MyappProperties添加@Component注解。
• 不要混淆@DefaultValue和Spring环境配置的作用域：前者仅填充属性类的字段，后者才是条件注解的判断依据。

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