WildFly本地访问资源提示FORBIDDEN且JAX_RS未部署求助

以下是针对问题的排查和解决步骤：

1. 确认WildFly的JAX-RS子系统已启用 #

管理控制台显示JAX_RS未部署，首先要确认服务器的JAX-RS子系统是否存在并启用：

• 打开WildFly管理控制台，进入配置 > 子系统，搜索jaxrs，如果找不到说明子系统未添加。
• 用WildFly CLI工具执行命令添加子系统：

  ./jboss-cli.sh --connect
  /subsystem=jaxrs:add()
  :reload
  

  执行后重启服务器，再检查子系统是否存在。

2. 修正应用的JAX-RS配置 #

方法一：使用web.xml配置 #

确保WEB-INF/web.xml中包含JAX-RS Servlet的配置（适配Jakarta EE 9+）：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd"
         version="6.0">
    <servlet>
        <servlet-name>Jakarta REST Servlet</servlet-name>
        <servlet-class>jakarta.ws.rs.core.Application</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>Jakarta REST Servlet</servlet-name>
        <url-pattern>/api/*</url-pattern>
    </servlet-mapping>
</web-app>

此时@Path("/health")资源的访问路径应为http://<host>:<port>/<context-root>/api/health。

方法二：扩展Application类 #

如果使用代码配置，确保Application类正确标注@ApplicationPath，且服务器能扫描到该类：

import jakarta.ws.rs.ApplicationPath;
import jakarta.ws.rs.core.Application;

@ApplicationPath("/api")
public class RestApplication extends Application {
    // 空实现即可，服务器会自动扫描带有@Path的资源类
}

3. 调整Maven依赖范围避免冲突 #

WildFly自带RESTEasy（Jakarta REST的实现），因此pom.xml中的Jakarta REST API依赖必须设为provided，避免打包时带入冲突的jar：

<dependency>
    <groupId>jakarta.ws.rs</groupId>
    <artifactId>jakarta.ws.rs-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>

如果引入其他REST相关扩展依赖，也要检查是否与WildFly版本兼容，必要时设为provided。

4. 验证资源类注解正确性 #

确保健康检查资源类的注解没有遗漏：

import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;

@Path("/health")
public class HealthResource {
    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String getHealthStatus() {
        return "UP";
    }
}

注意：如果使用Application类显式注册资源，要在getClasses()方法中添加该类；如果是自动扫描，确保资源类和Application类在同一个包或子包下（默认扫描范围）。

5. 排查安全配置导致的403错误 #

• 检查web.xml中是否存在<security-constraint>配置，意外限制了/health路径的访问。如果不需要安全验证，移除相关配置，或者添加规则排除健康检查路径：

  <security-constraint>
      <web-resource-collection>
          <web-resource-name>Protected Resources</web-resource-name>
          <url-pattern>/*</url-pattern>
          <exclude-url-pattern>/api/health</exclude-url-pattern>
      </web-resource-collection>
      <!-- 其他安全配置 -->
  </security-constraint>
  

• 查看WildFly的standalone.xml，检查是否有全局安全域配置强制所有web应用启用认证，必要时调整配置或为你的应用指定无安全约束的域。

6. 查看服务器日志定位问题 #

如果以上步骤都无效，查看WildFly的standalone/log/server.log，搜索jaxrs、deploy、error等关键词，找到部署时的具体错误信息（比如类加载失败、注解扫描异常、子系统初始化错误等），这些日志是定位问题的关键。

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