Quarkus中@UnlessBuildProperty与@ApplicationScoped、@Scheduled失效问题排查

问题根源 #

1. 注解顺序错误
   Quarkus的条件注解（如@UnlessBuildProperty）需要作用在已标记为Bean的类上。如果将@UnlessBuildProperty放在@ApplicationScoped之前，可能导致框架无法正确识别Bean的Scope，进而出现Bean不实例化或定时任务无法注册的问题。

2. 属性值匹配的潜在问题
   @UnlessBuildProperty的stringValue参数是基于属性的字符串形式进行匹配的。如果配置文件中属性的类型与注解预期的字符串不匹配（比如误将布尔值配置为数字类型），会导致条件判断逻辑异常，出现类意外被排除或实例化后定时任务失效的情况。

修复步骤 #

1. 调整注解顺序
   将@ApplicationScoped放在@UnlessBuildProperty之前，确保框架先识别Bean的Scope，再通过条件注解控制Bean是否启用：

@ApplicationScoped
@UnlessBuildProperty(name = "someservice.enabled", stringValue = "false")
public class SomeService{

  @Scheduled(every = "${check.interval:1M}")
  public void process() {
     //do something
  }
}

2. 确保属性配置正确
   在application.properties中配置属性时，保证其字符串形式与注解的stringValue一致：

# 布尔类型配置，会自动转换为字符串"false"匹配条件
someservice.enabled=false
# 或直接使用字符串配置
someservice.enabled="false"

3. 验证构建逻辑
   构建应用时通过参数验证条件是否生效：

• 执行./mvnw clean package -Dsomeservice.enabled=false构建，检查应用中是否不存在SomeService的实例；
• 执行./mvnw clean package -Dsomeservice.enabled=true（或不指定该参数）构建，验证process方法是否按配置的间隔执行。

4. 升级Quarkus版本（可选）
   如果使用的是Quarkus 2.x以前的旧版本，可能存在条件注解与定时任务的兼容Bug，建议升级到最新稳定版。

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