能否为JAX-RS ExceptionMapper添加拦截器？拦截器未触发求助

为什么拦截器没生效？ #

JAX-RS的ExceptionMapper本质上是由JAX-RS运行时管理的组件，哪怕你加了@Stateless注解，默认也不会被CDI容器接管。CDI拦截器只能作用于CDI管理的Bean，所以你的拦截器自然触发不了。

三种可行解决方案 #

1. 把ExceptionMapper纳入CDI管理（用扩展） #

写个CDI扩展，让所有标注了@Provider的ExceptionMapper都变成CDI Bean：

public class ExceptionMapperCDIExtension implements Extension {
    void registerExceptionMappers(@Observes ProcessAnnotatedType<?> pat) {
        Class<?> clazz = pat.getAnnotatedType().getJavaClass();
        if (clazz.isAnnotationPresent(Provider.class) && ExceptionMapper.class.isAssignableFrom(clazz)) {
            pat.configureAnnotatedType().add(Stateless.class);
        }
    }
}

然后在META-INF/services/jakarta.enterprise.inject.spi.Extension（Jakarta EE）或javax.enterprise.inject.spi.Extension（Java EE）文件里添加这个类的全限定名。之后给你的ABCExceptionMapper加上@Stateless和@Interceptors注解，CDI就会接管它的实例化，拦截器就能正常触发了。

2. 用抽象基类强制实现逻辑（最简单可靠） #

不用拦截器，直接搞个抽象基类，把存储异常消息的逻辑写死在父类，子类只能实现响应构建：

public abstract class BaseExceptionMapper<E extends Exception> implements ExceptionMapper<E> {
    @Inject
    private RequestScopedExceptionHolder exceptionHolder;

    @Override
    public final Response toResponse(E exception) {
        // 强制存消息，子类绕不开
        exceptionHolder.setExceptionMessage(exception.getMessage());
        return buildCustomResponse(exception);
    }

    // 子类必须实现这个方法来做响应构建
    protected abstract Response buildCustomResponse(E exception);
}

然后让你的Mapper继承这个基类：

@Provider
public class ABCExceptionMapper extends BaseExceptionMapper<ABCException> {
    @Override
    protected Response buildCustomResponse(ABCException exception) {
        // 这里只需要处理响应内容，消息存储已经搞定
        return Response.status(Response.Status.BAD_REQUEST)
                       .entity("请求错误：" + exception.getMessage())
                       .build();
    }
}

这种方式从代码结构上强制开发人员遵守规则，完全不用考虑拦截器的问题，最省心。

3. 用JAX-RS过滤器捕获异常信息 #

通过ContainerResponseFilter在响应阶段获取异常并存储：

@Provider
public class ExceptionMessageStorageFilter implements ContainerResponseFilter {
    @Inject
    private RequestScopedExceptionHolder exceptionHolder;

    @Override
    public void filter(ContainerRequestContext requestCtx, ContainerResponseContext responseCtx) throws IOException {
        Throwable exception = (Throwable) requestCtx.getProperty("javax.ws.rs.container.ResourceInfo.EXCEPTION");
        if (exception != null) {
            exceptionHolder.setExceptionMessage(exception.getMessage());
        }
    }
}

不过要注意，这个属性的键在不同JAX-RS实现（比如Jersey、RESTEasy）里可能有差异，兼容性不如基类方案。

额外提醒 #

• 确保你的@RequestScoped Bean是标准CDI Bean，没有作用域冲突（比如不要在非CDI环境中注入）。
• 如果用的是Jakarta EE，记得把javax.ws.rs换成jakarta.ws.rs相关包。

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