Keycloak Quarkus自定义SPI中@Scheduled方法未触发排查

以下是你可能遗漏的关键步骤：

• Provider未被Quarkus CDI容器托管
  Keycloak部分Provider是通过自定义工厂（ProviderFactory）直接实例化的，这类实例不受Quarkus CDI容器管理，@Scheduled注解自然不会生效。需要确保你的Provider是CDI托管Bean：

  • 给Provider类添加@jakarta.inject.Named或@javax.inject.Named注解（根据Keycloak版本选择Jakarta/Javax包）
  • 或在ProviderFactory中通过CDI获取实例，而非直接new对象

• 未以Quarkus扩展格式打包
  普通JAR放入providers目录时，Quarkus不会处理其中的注解（包括@Scheduled）。必须将Provider打包为Quarkus扩展：

  • 在pom.xml中引入quarkus-extension-maven-plugin插件
  • 配置<quarkus.extension>true</quarkus.extension>属性，标记当前项目为Quarkus扩展
  • 执行mvn clean package生成扩展专用JAR（通常带quarkus-extension后缀）

• @Scheduled注解使用不规范
  确认注解参数和方法符合要求：

  • 必须指定触发规则，比如@Scheduled(every = "10s")（注意是字符串格式的时间表达式）
  • 定时方法必须是无参、返回值为void的方法
  • 方法访问修饰符建议设为public（Quarkus允许private，但Keycloak环境可能存在限制）

• 依赖配置不匹配
  确保scheduler依赖版本与Keycloak Quarkus版本完全一致，且依赖范围正确：

  <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-scheduler</artifactId>
      <version>${keycloak.quarkus.version}</version>
      <scope>provided</scope>
  </dependency>
  

  （将${keycloak.quarkus.version}替换为你使用的Keycloak对应Quarkus版本，比如Keycloak 22对应Quarkus 2.16.8.Final）

• 未显式启用Scheduler扩展
  在扩展资源文件src/main/resources/META-INF/quarkus-extension.properties中添加配置：

  quarkus.extension.name=your-custom-provider-extension
  quarkus.scheduler.enabled=true
  

  确保Quarkus启动时加载并启用Scheduler功能

• 检查启动日志定位问题
  查看Keycloak启动日志，搜索scheduler相关关键字，确认是否存在扩展加载失败、定时任务未注册的WARN或ERROR信息，这些日志能直接指向问题根源

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