JBoss EAP 6.2中resteasy-jaxrs配置依赖及REST接口404问题咨询

看起来你在为MethodNotAllowedException添加错误处理器的过程中，引入了依赖和Servlet配置的连锁问题，导致原本正常的REST资源无法被Resteasy识别了。我结合JBoss EAP 6.x的特性，给你梳理几个关键排查和修复步骤：

1. 先解决依赖冲突问题 #

JBoss EAP 6.2自带了Resteasy 2.3.10.Final，你手动添加的resteasy-jaxrs依赖很可能和容器自带版本不兼容，引发类加载混乱，导致资源扫描失败。把依赖改成provided范围，让容器提供原生类库：

<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-jaxrs</artifactId>
    <version>2.3.10.Final</version>
    <scope>provided</scope>
</dependency>

划重点：JBoss EAP的Resteasy是绑定在容器模块里的，绝对不要引入不同版本的Resteasy依赖，否则会出现各种类加载异常。

2. 修正Servlet配置，确保资源能被扫描到 #

改用HttpServlet30Dispatcher后，必须保证配置里正确指定了REST资源的扫描规则。检查你的web.xml：

<servlet>
    <servlet-name>ResteasyDispatcher</servlet-name>
    <servlet-class>org.jboss.resteasy.plugins.server.servlet.HttpServlet30Dispatcher</servlet-class>
    <!-- 方式1：用Application子类手动注册资源和处理器 -->
    <init-param>
        <param-name>javax.ws.rs.Application</param-name>
        <param-value>com.your.app.YourRestApplication</param-value>
    </init-param>
    <!-- 方式2：开启自动扫描（适合简单项目） -->
    <!--
    <init-param>
        <param-name>resteasy.scan</param-name>
        <param-value>true</param-value>
    </init-param>
    -->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>ResteasyDispatcher</servlet-name>
    <url-pattern>/api/*</url-pattern> <!-- 要和你的API前缀匹配 -->
</servlet-mapping>

如果用方式1的Application子类，记得把资源类和异常处理器都加进去：

import java.util.HashSet;
import java.util.Set;
import javax.ws.rs.core.Application;

public class YourRestApplication extends Application {
    @Override
    public Set<Class<?>> getClasses() {
        Set<Class<?>> classes = new HashSet<>();
        // 添加你的REST资源类
        classes.add(com.your.resource.UserResource.class);
        // 添加MethodNotAllowedException的处理器
        classes.add(com.your.exception.MethodNotAllowedMapper.class);
        return classes;
    }
}

3. 检查异常处理器的实现是否规范 #

你的异常处理器必须是@Provider注解的ExceptionMapper实现，Resteasy才能识别它：

import javax.ws.rs.core.Response;
import javax.ws.rs.ext.ExceptionMapper;
import javax.ws.rs.ext.Provider;
import org.jboss.resteasy.spi.MethodNotAllowedException;

@Provider
public class MethodNotAllowedMapper implements ExceptionMapper<MethodNotAllowedException> {
    @Override
    public Response toResponse(MethodNotAllowedException e) {
        return Response.status(Response.Status.METHOD_NOT_ALLOWED)
                .entity("不允许的请求方法：" + e.getMethod())
                .build();
    }
}

这个类要么被resteasy.scan自动扫描到，要么手动加到Application的getClasses()里，否则Resteasy不会加载它。

4. 查看服务器日志找线索 #

启动JBoss后，去standalone/log/server.log里找这些关键信息：

• Resteasy初始化日志：确认有没有打印"Scanning for REST resources"之类的信息，以及资源类是否被成功注册
• 类加载错误：如果有ClassNotFoundException或NoClassDefFoundError，说明依赖还是有问题
• 404的详细堆栈：看Resteasy是因为找不到资源路径，还是根本没扫描到资源

最后验证 #

重启JBoss后，用curl或Postman测试一个简单的接口，比如GET /api/users，如果还是404，先确认Servlet映射的路径和接口的@Path是否匹配，比如接口的@Path("/users")加上Servlet的/api/*，完整路径就是/api/users，别搞混了。

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