多@PropertySource下@ConditionalOnProperty生效异常问题排查

看起来你遇到的核心问题是Spring的@ConditionalOnProperty是基于合并后的全局属性集判断，而非单个PropertySource，再加上你的配置类里用了@Profile限制another.properties的加载，导致属性判断逻辑和你预期的不一致。我来一步步拆解问题和解决方案：

问题根源分析 #

1. @Profile导致属性源加载受限：你的WarDeploymentConfig标注了@Profile("war-deployment")，这意味着只有激活该profile时，another.properties才会被加载。如果没激活这个profile，feature.enabled这个属性根本不存在于全局属性集中，导致两个Feature实现类的@ConditionalOnProperty条件都不满足——既不是true也不是false，所以没有Bean被注册。

2. matchIfMissing的误用：当你给FeatureNoOp加上matchIfMissing=true时，只要feature.enabled不存在或者为false，它就会被加载。但如果激活了war-deployment profile，another.properties里的feature.enabled=true会让FeatureImpl的条件也满足，此时两个Bean都会被加载（因为matchIfMissing=true让FeatureNoOp的条件依然成立），这显然不是你想要的。

3. @ConditionalOnMissingBean未生效的原因：你之前加这个注解没起作用，大概率是因为两个Bean的条件同时满足，Spring在处理条件时，@ConditionalOnProperty的判断优先级高于@ConditionalOnMissingBean，导致两个Bean都进入候选池，最终都被注册。

解决方案 #

1. 移除@Profile，用条件注解控制属性源加载（符合你不想用profile的需求） #

把WarDeploymentConfig上的@Profile换成@ConditionalOnProperty，用属性来控制another.properties的加载，避免依赖profile：

@Configuration
@PropertySource("classpath:application.properties")
public class Config {
    //...
    @Order(Ordered.HIGHEST_PRECEDENCE) // 确保another.properties的属性优先级更高
    @Configuration
    @PropertySource("classpath:another.properties")
    @ConditionalOnProperty(name = "deployment.type", havingValue = "war") // 用属性代替profile
    public static class WarDeploymentConfig {
        //...
    }
}

这样，当deployment.type=war时，another.properties会被加载，否则不加载，完全由属性控制，和profile解耦。

2. 调整两个Feature实现类的条件注解，确保互斥加载 #

修改两个Bean的条件，让它们互斥：一个在属性为true时加载，另一个在属性为false或不存在时加载，同时用@ConditionalOnMissingBean保证只有一个Bean被注册：

实际实现类FeatureImpl

@Service
@Slf4j
@ConditionalOnProperty(name = "feature.enabled", havingValue = "true")
public class FeatureImpl implements Feature {}

空实现类FeatureNoOp

@Service
@Slf4j
// 当属性为false OR 属性不存在时生效
@ConditionalOnProperty(name = "feature.enabled", havingValue = "false", matchIfMissing = true)
// 只有当Feature类型的Bean不存在时才加载（避免和FeatureImpl冲突）
@ConditionalOnMissingBean(Feature.class)
public class FeatureNoOp implements Feature {}

3. 验证逻辑是否符合预期 #

• 当deployment.type=war且another.properties中feature.enabled=true时：FeatureImpl的条件满足，被注册；此时Feature.class的Bean已存在，FeatureNoOp的@ConditionalOnMissingBean条件不满足，不会被加载。
• 当deployment.type≠war（another.properties未加载），或another.properties中feature.enabled=false时：FeatureImpl的条件不满足；FeatureNoOp的@ConditionalOnProperty条件满足，且此时没有其他FeatureBean，所以FeatureNoOp被注册。
• 当another.properties未加载且application.properties也没定义feature.enabled时：FeatureNoOp的matchIfMissing=true生效，被注册为默认实现。

额外提醒 #

• 属性优先级：@Order(Ordered.HIGHEST_PRECEDENCE)确保another.properties的属性会覆盖application.properties中的同名属性，这符合你需要优先使用another.properties配置的预期。
• 避免属性冲突：如果多个PropertySource中存在同名属性，Spring会按照PropertySource的优先级（由@Order或加载顺序）来覆盖，确保最终的全局属性是你期望的值。

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