Wildfly 26容器中REST服务POST请求不响应问题求助

在Kubernetes Pod中运行Wildfly 26应用服务器，已配置JAX-RS REST服务：

@ApplicationPath("/rest")
public class RestApplicationConfig extends Application {
    // intentionally empty
}

通过连接Kubernetes的VM使用curl测试：

curl -X  POST 201.119.108.16:8080/visualcode/rest/getbropr

控制台DEBUG日志显示：

21:56:10,151 DEBUG [io.undertow.request] (default I/O-1) Matched prefix path /visualcode for path /visualcode/rest/getbropr

Wildfly已接收请求，但curl返回错误：

<html><head><title>Error</title></head><body>HTTP method POST is not supported by this URL</body></html>

该应用在Windows本地开发环境运行时，curl请求正常，Java服务代码如下：

@POST
@Path("/getbropr")
public Response getBrowserProperties() {
    BrowserProperties bp = bean.getBrowserProperties();
    Map<String,Object> map = new HashMap<>();
    map.put("props", bp);
    map.put(Constant.Key.Ret, Constant.Code.Success);
    ObjectMapper om = new ObjectMapper();
    String json = om.writeValueAsString(map);
    return Response.ok(json).build();
}

已排除中间路由问题，请问该如何解决？

1. 核查JAX-RS资源类的扫描范围 #

你的RestApplicationConfig是空实现，Wildfly默认会扫描该类所在包及其子包下的JAX-RS资源类。如果K8s环境中应用打包结构有问题，比如getBrowserProperties所在的包不在RestApplicationConfig的扫描范围内，会导致资源未被注册。

• 确认资源类和RestApplicationConfig是否在同一包或子包下；
• 若不在扫描范围，修改RestApplicationConfig显式注册资源类：

@ApplicationPath("/rest")
public class RestApplicationConfig extends Application {
    @Override
    public Set<Class<?>> getClasses() {
        Set<Class<?>> classes = new HashSet<>();
        classes.add(你的资源类.class);
        return classes;
    }
}

2. 检查应用上下文路径的部署差异 #

从日志看Undertow匹配的前缀是/visualcode，说明K8s环境中Wildfly的应用上下文路径是/visualcode，但本地开发时可能上下文路径为空或不同。

• 检查Kubernetes部署配置，确认是否指定了应用上下文路径为/visualcode；
• 可以临时添加一个GET方法到同一个路径做测试：

@GET
@Path("/getbropr")
public String testPath() {
    return "Path accessible";
}

执行curl 201.119.108.16:8080/visualcode/rest/getbropr，如果能返回内容，说明路径正确但POST资源未注册；如果仍报错，说明路径匹配存在异常。

3. 排查Wildfly部署配置与包完整性 #

本地和K8s环境的Wildfly配置可能存在差异：

• 检查K8s中Wildfly是否启用了JAX-RS扩展（Wildfly 26默认启用，但不排除部署时被禁用）；
• 验证K8s中部署的war/jar包是否完整，是否遗漏了JAX-RS相关依赖或配置文件；
• 查看Wildfly的完整日志，排查是否存在资源类加载失败、初始化异常等信息，这类问题会导致资源未被正确注册，进而出现“不支持POST方法”的错误。

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