Keycloak 15.0.2部署WildFly 25时报KEYCLOAK认证机制不可用错误

问题根因 #

该错误本质是WildFly的Elytron安全子系统未正确加载Keycloak适配器提供的认证机制，即使你手动修改了standalone.xml的http-authentication-factory节点，也会因为依赖的全局注册配置缺失不生效。

排查&解决步骤 #

• 首先确认你是否完整执行了Keycloak适配器的安装配置流程，仅将适配包解压到WildFly根目录不会自动注册认证机制：
  进入WildFly的bin目录，启动WildFly实例后执行以下CLI命令完成适配器注册：

  jboss-cli.sh --connect --file=../bin/adapter-elytron-install-offline.cli
  

  注意：如果你用的是standalone模式，不要使用旧版的adapter-install.cli脚本，必须用elytron后缀的适配脚本
• 确认你修改的standalone.xml是当前WildFly启动时加载的配置文件，如果你启动时指定了-c standalone-full.xml等参数，需要对应修改指定的配置文件。
• 检查standalone.xml中是否正确配置了应用安全域绑定，确保有以下配置段：

  <subsystem xmlns="urn:wildfly:elytron:15.0">
      <application-security-domains>
          <application-security-domain name="keycloak" http-authentication-factory="keycloak-http-authentication"/>
      </application-security-domains>
  </subsystem>
  

  同时确认你的web.xml中配置的security-domain值和上面配置的name属性完全一致。
• 如果你是首次安装适配器，执行完配置脚本后必须完全重启WildFly实例，热重载配置不会生效。
• 确认WildFly 25的启动配置没有禁用elytron子系统，也没有加载冲突的旧版Keycloak适配包。

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