Keycloak User Storage SPI导入问题：UserStorageProvider无法找到

• 依赖模块拆分：Keycloak 19.0.0起对核心依赖做了模块化拆分，UserStorageProvider所在的org.keycloak.storage包不再包含在默认核心依赖（如keycloak-core）中，需单独引入keycloak-storage-api模块。
• 依赖版本不统一：若项目中各Keycloak组件依赖版本不一致（比如部分用19.x之前版本，部分用20.0.3），会引发类路径冲突，导致接口无法被找到。
• 构建依赖配置错误：检查Maven/Gradle配置，确认是否正确引入keycloak-storage-api依赖。
  Maven示例配置：

  <dependency>
      <groupId>org.keycloak</groupId>
      <artifactId>keycloak-storage-api</artifactId>
      <version>20.0.3</version>
      <scope>provided</scope>
  </dependency>
  

  Gradle示例配置：

  compileOnly 'org.keycloak:keycloak-storage-api:20.0.3'
  

• 类路径缺失：若手动管理类路径，未将keycloak-storage-api-20.0.3.jar加入项目类路径，会导致编译时无法定位该接口。

内容的提问来源于stack exchange，提问作者S. Dre