Spring Boot：当存在指定前缀的任意属性时启用自动配置

你提到的问题很典型——@ConditionalOnProperty的默认行为是精确匹配单个属性名，所以直接设置name="test.property"只会检查这个 exact 属性是否存在，而不会识别它的子属性（比如test.property.any-text-goes-here.some-nested-property）。不用自定义Condition的话，确实可以通过@ConditionalOnExpression结合SpEL表达式来实现你的需求，下面是具体的解决方案：

方法一：使用@ConditionalOnExpression匹配前缀属性 #

Spring的Environment对象可以访问所有已加载的配置属性，我们可以通过SpEL表达式调用它的API来检查是否存在指定前缀的属性。

代码示例 #

@Configuration
// 匹配所有以"test.property"开头的属性（包括test.property本身及其子属性）
@ConditionalOnExpression("environment.getPropertyNames().stream().anyMatch(name -> name.startsWith('test.property'))")
public class TestAutoConfiguration {

    // 你的配置Bean定义
    @Bean
    public SomeBean someBean() {
        return new SomeBean();
    }

    public static class SomeBean {}
}

表达式说明 #

• environment：SpEL可以直接引用Spring上下文里的Environment实例
• getPropertyNames()：返回所有已加载的配置属性名（来自application.yml/properties、环境变量等）
• stream().anyMatch(...)：流式检查是否存在任意一个属性名以test.property开头

按需调整匹配规则 #

如果你只想匹配test.property的子属性（不想匹配test.property本身），只需要把前缀改成test.property.（注意末尾的点）：

@ConditionalOnExpression("environment.getPropertyNames().stream().anyMatch(name -> name.startsWith('test.property.'))")

为什么之前的@ConditionalOnProperty不生效？ #

@ConditionalOnProperty(name = "test.property")的逻辑是：只有当配置中精确存在test.property这个属性，且它的值不是false（默认havingValue = ""，只要属性存在就生效）时，配置类才会被加载。而你实际使用的是test.property的子属性，所以这个条件自然不满足。

额外提示 #

这种方式完全依赖Spring原生的注解和SpEL，不需要编写自定义Condition类，既简洁又符合Spring Boot的自动配置风格。只要你的配置文件中存在任何符合前缀规则的属性，这个配置类就会被自动注册到Spring上下文。

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