如何在WildFly 11中将RESTEasy Application配置在根路径“/”

我完全懂你遇到的这个麻烦——把JAX-RS应用的根路径设为/后，RESTEasy默认注册的HttpServlet30Dispatcher会拦截所有请求，不管是REST接口还是静态资源、其他Servlet的请求，这确实很头疼。好在有几个方案可以解决，既能保留自动资源扫描，又能让RESTEasy只处理该处理的请求：

方案1：将RESTEasy注册为过滤器（推荐） #

RESTEasy支持以过滤器模式运行，这种方式比Servlet更灵活，你可以把它映射到/，同时避免完全垄断所有请求的处理，还能保留自动资源扫描功能。

你需要在web.xml中添加以下配置，手动指定RESTEasy的过滤器Dispatcher：

<filter>
    <filter-name>ResteasyFilterDispatcher</filter-name>
    <filter-class>org.jboss.resteasy.plugins.server.servlet.FilterDispatcher</filter-class>
    <init-param>
        <!-- 指定你的JAX-RS Application类 -->
        <param-name>javax.ws.rs.Application</param-name>
        <param-value>com.yourpackage.JaxrsConfiguration</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>ResteasyFilterDispatcher</filter-name>
    <url-pattern>/</url-pattern>
    <!-- 可选：配置Dispatcher类型，避免拦截内部转发的请求，比如JSP转发 -->
    <dispatcher>REQUEST</dispatcher>
    <dispatcher>ASYNC</dispatcher>
</filter-mapping>

这样配置后，FilterDispatcher会处理根路径下的REST请求，但不会像Servlet那样拦截所有/*的请求。同时，你的JaxrsConfiguration类因为没有重写getClasses()或getSingletons()方法，RESTEasy依然会自动扫描并注册所有带@Path注解的资源类，完全保留自动扫描的特性。

方案2：调整Servlet映射为/，并优先处理静态资源 #

如果你更倾向于用Servlet模式，也可以手动将RESTEasy的Servlet映射到/，同时配置让默认Servlet优先处理静态资源，避免RESTEasy拦截这些请求。

在web.xml中添加如下配置：

<!-- 注册RESTEasy Servlet -->
<servlet>
    <servlet-name>ResteasyServletDispatcher</servlet-name>
    <servlet-class>org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher</servlet-class>
    <init-param>
        <param-name>javax.ws.rs.Application</param-name>
        <param-value>com.yourpackage.JaxrsConfiguration</param-value>
    </init-param>
</servlet>
<!-- 映射到根路径 -->
<servlet-mapping>
    <servlet-name>ResteasyServletDispatcher</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

<!-- 让默认Servlet优先处理静态资源 -->
<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>*.html</url-pattern>
    <url-pattern>*.css</url-pattern>
    <url-pattern>*.js</url-pattern>
    <url-pattern>*.png</url-pattern>
    <!-- 根据你的需求添加其他静态资源后缀 -->
</servlet-mapping>

Servlet规范中，更具体的URL模式（比如*.html）会比/这种默认模式优先匹配，所以静态资源请求会被默认Servlet处理，剩下的请求才会交给RESTEasy的Servlet。同样，因为指定了你的JaxrsConfiguration类，自动资源扫描功能也会保留。

关键注意事项 #

在WildFly 11中，如果你只使用@ApplicationPath("/")注解而没有手动配置web.xml，RESTEasy的自动初始化器会自动将HttpServlet30Dispatcher注册到/*。所以必须通过web.xml手动配置过滤器或Servlet映射，手动配置的优先级会覆盖自动注册的规则，这样才能达到你想要的效果。

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