基于JBoss standalone.xml转换Thorntail project-defaults.yaml配置报错求助

先来看你遇到的核心报错：

ERROR [org.jboss.as.controller] (Controller Boot Thread) WFLYCTL0362: Capabilities required by resource '/subsystem=undertow/server=default/host=default/location=default' are not available: org.wildfly.extension.undertow.handler.properties; Possible registration points for this capability: /subsystem=undertow/configuration=handler/file=* /subsystem=undertow/configuration=handler/reverse-proxy=*

这个问题的根源很明确：你的YAML配置没有正确定义properties这个文件处理器，同时location的路径与处理器的映射也和原standalone.xml不匹配，导致系统找不到对应的capability。

结合你原有的standalone.xml配置，我帮你修正了完整的project-defaults.yaml：

swarm:
  undertow:
    # 对应原xml中的<buffer-cache name="default"/>
    buffer-caches:
      default: {}
    # 全局默认配置，对齐原xml的subsystem根节点属性
    default-server: default-server
    default-virtual-host: default-host
    default-servlet-container: default
    default-security-domain: sdom
    # 正确定义两个file handler，对应原xml的<handlers>节点内容
    handler-configuration:
      files:
        welcome-info:
          path: "${jboss.home.dir}/welcome-info"
          directory-listing: false
        properties:
          path: "${jboss.home.dir}/"
          directory-listing: true
    # 服务器配置，对应原xml的<server name="default-server">
    servers:
      default-server:
        http-listeners:
          default:
            enable-http2: true
            redirect-socket: https
            socket-binding: http
        https-listeners:
          https:
            enable-http2: true
            security-realm: ApplicationRealm
            socket-binding: https
        hosts:
          default-host:
            alias: localhost
            # 对齐原xml的两个location节点，路径与处理器一一对应
            locations:
              "/":
                handler: welcome-info
              "/prop":
                handler: properties
            # 对应原xml的<http-invoker security-realm="ApplicationRealm"/>
            http-invoker-setting:
              security-realm: ApplicationRealm
    # Servlet容器配置，对应原xml的<servlet-container name="default">
    servlet-containers:
      default:
        jsp-config: {}
        websockets: {}

关键修正点说明： #

• 补全缺失的处理器定义：原standalone.xml里有welcome-info和properties两个file handler，你之前只定义了一个名为default的处理器，完全漏掉了properties，这是报错的直接原因。现在按照原xml的参数把两个处理器都配置完整。
• 修正location映射关系：原xml里/路径对应welcome-info处理器，/prop路径对应properties处理器，你之前的YAML把这层映射搞反了，现在调整为正确的对应关系。
• 对齐全局配置项：补全了buffer-caches、default-server等原xml里的全局属性，确保YAML配置和原standalone.xml的语义完全一致。
• 修正服务器名称：原xml里服务器名称是default-server，你之前写的是default，导致配置节点不匹配，现在统一为default-server。

现在启动应用应该就能正常加载Undertow子系统，不会再出现capability缺失的报错了。

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