Spring Boot应用中HandlerInterceptor是否对JAX-RS REST控制器生效？

核心结论 #

Spring 原生的HandlerInterceptor默认无法对JAX-RS实现的REST控制器生效。

底层原因 #

HandlerInterceptor是Spring MVC栈专属的拦截组件，它的触发逻辑绑定在Spring MVC核心分发器DispatcherServlet的请求处理链路中。而JAX-RS的实现（比如Jersey、Apache CXF）通常会注册独立的Servlet/过滤器来接管JAX-RS接口的请求分发，不会走Spring MVC的DispatcherServlet处理流程，因此HandlerInterceptor的逻辑不会被触发。

可行替代方案 #

如果需要对JAX-RS接口实现类似拦截器的切面逻辑，可选择以下两种方案：

• 方案1：使用JAX-RS原生拦截器
  JAX-RS规范自带ContainerRequestFilter（请求前置拦截）和ContainerResponseFilter（响应后置拦截），所有兼容JAX-RS规范的实现都支持。如果需要在拦截器中注入Spring管理的Bean，只需将Filter类声明为Spring Bean，再注册到JAX-RS的配置类中即可。
  示例代码：

// 自定义JAX-RS拦截器
@Component
public class CustomJaxrsInterceptor implements ContainerRequestFilter, ContainerResponseFilter {
    // 可正常注入Spring Bean
    @Autowired
    private UserAuthService userAuthService;

    @Override
    public void filter(ContainerRequestContext requestContext) throws IOException {
        // 编写请求进入控制器前的逻辑，比如身份校验、参数校验
    }

    @Override
    public void filter(ContainerRequestContext requestContext, ContainerResponseContext responseContext) throws IOException {
        // 编写控制器返回后的逻辑，比如统一添加响应头、日志埋点
    }
}

以Jersey实现为例，注册拦截器：

@Component
public class JerseyConfig extends ResourceConfig {
    public JerseyConfig(CustomJaxrsInterceptor interceptor) {
        // 注册自定义拦截器
        register(interceptor);
        // 扫描JAX-RS控制器所在包
        packages("com.example.jaxrs.controller");
    }
}

• 方案2：使用Servlet级别的Spring过滤器
  直接实现Spring的GenericFilterBean或者原生javax.servlet.Filter，声明为Spring Bean后会自动对所有请求生效，包括Spring MVC接口和JAX-RS接口，不需要适配JAX-RS规范。

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