WildFly21迁移至24时microprofile子系统报错导致服务启动失败

WildFly自23版本起对MicroProfile健康检查、指标模块做了架构拆分：microprofile-health-smallrye、microprofile-metrics-smallrye两个上层子系统不再内置HTTP上下文、服务探针的实现逻辑，这部分能力被抽成了独立的health、metrics核心扩展，必须显式配置才能提供对应capability。
你当前报错的直接原因有两个：

• 仅添加了上层MicroProfile系列扩展与子系统，缺失底层核心扩展配置
• 修改的是standalone系列默认配置文件，服务实际启动加载的是其他自定义配置，修改内容未生效
  服务无法启动时无法使用联机模式的jboss-cli，可通过以下两种方案修复。

方案1：直接编辑实际加载的配置文件（操作最快） #

• 定位实际启动配置：查看服务启动脚本/启动命令中-c参数指定的配置文件名，配置文件默认存放在${WILDFLY_HOME}/standalone/configuration/目录下。
• 打开对应xml文件，在<extensions>节点下追加两个核心扩展配置：

<extension module="org.wildfly.extension.health"/>
<extension module="org.wildfly.extension.metrics"/>

• 在<profile>节点下（与其他subsystem配置同级）追加两个核心子系统配置：

<subsystem xmlns="urn:wildfly:health:2.0" security-enabled="false"/>
<subsystem xmlns="urn:wildfly:metrics:2.0" security-enabled="false"/>

• 保存文件后重启服务即可。
  注：之前添加的microprofile-health-smallrye、microprofile-metrics-smallrye相关扩展和子系统配置无需删除，核心扩展是这两个上层子系统的运行依赖，二者共存不冲突。

方案2：使用jboss-cli离线嵌入式模式修改（避免手动编辑xml的格式错误） #

jboss-cli支持嵌入式离线模式，可以直接修改本地配置文件，不需要连接运行中的WildFly实例：

• 进入${WILDFLY_HOME}/bin目录，执行命令启动离线CLI，注意替换命令中的配置文件名为实际启动使用的文件名：
  • Linux/Unix环境：

  ./jboss-cli.sh --embed-server --server-config=你的实际配置文件名.xml
  

  • Windows环境：

  jboss-cli.bat --embed-server --server-config=你的实际配置文件名.xml
  

• 进入CLI交互界面后，依次执行以下命令添加缺失的扩展和子系统：

/extension=org.wildfly.extension.health:add
/extension=org.wildfly.extension.metrics:add
/subsystem=health:add(security-enabled=false)
/subsystem=metrics:add(security-enabled=false)

• 执行命令保存配置并退出嵌入式服务：

:write-config
exit

• 正常启动WildFly服务即可。

服务启动成功后，可直接访问以下地址验证能力是否正常：

• 健康检查地址：http://<服务器IP>:9990/health，返回200状态码及UP状态即为正常
• 指标接口地址：http://<服务器IP>:9990/metrics，返回文本格式的指标数据即为正常

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