如何自定义继承@ConditionalOnProperty且预定义属性键的@Country注解？

云原生阿岚

2026-5-15

如何正确实现自定义的@Country条件注解替代@ConditionalOnProperty？

你的问题核心是想用自定义注解简化@ConditionalOnProperty(name = "country", havingValue = "xxx")的写法，但元注解配置没被Spring正确识别。问题出在注解属性的别名映射和默认属性名上，下面是正确的实现方案：

正确的@Country注解实现

要让Spring正确识别这个元注解，需要做到两点：

把自定义注解的默认属性设为value（这样就能用@Country("en")这种简化写法）
用@AliasFor正确绑定到ConditionalOnProperty的对应属性

完整代码如下：

@ConditionalOnProperty(name = "country")
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Documented
public @interface Country {
    // 把默认属性设为value，同时映射到ConditionalOnProperty的havingValue
    @AliasFor(annotation = ConditionalOnProperty.class, attribute = "havingValue")
    String value() default "";
}

使用示例

现在你可以直接用简化写法标记你的Service类了：

@Country("de")
@Service
class WizardServiceGermany {
    @Override
    void doMagic() {
        System.out.println("Simsalabim!");
    }
}

@Country("en")
@Service
class WizardServiceGreatBritain {
    @Override
    void doMagic() {
        System.out.println("Wingardium Leviosa!");
    }
}