ExceptionMapper类的toResponse方法未触发调用问题排查

我来帮你梳理下常见的原因和解决办法，这种问题我之前在项目里也遇到过，大概率是以下几个点没处理好：

1. 忘记给ExceptionMapper添加@Provider注解 #

这是最容易踩的坑！JAX-RS框架只会识别带有@Provider注解的ExceptionMapper实现类，你的代码里没加这个注解，框架根本不知道它的存在。

修改后的代码应该是这样：

import javax.ws.rs.ext.Provider;
import javax.ws.rs.core.Response;
import javax.validation.ConstraintViolationException;

@Provider // 必须加上这个注解！
public class PortalExceptionMapper implements ExceptionMapper<ConstraintViolationException> {
    @Override
    public Response toResponse(ConstraintViolationException exception) {
        System.out.println("%%%%%%%%%%%%%%%%%%%%%%%% testing product%%%%%%%%%%%%%%%%%%%%%%%%%%%%");
        return Response.status(Response.Status.BAD_REQUEST)
                .entity(prepareMessage(exception))
                .type("application/json")
                .build();
    }

    private String prepareMessage(ConstraintViolationException exception) {
        // 你的消息处理逻辑
        return exception.getMessage();
    }
}

2. 实际抛出的异常类型不匹配 #

仔细检查你代码里抛出的异常是不是真正的ConstraintViolationException？有时候可能会出现异常被包装的情况，比如外层是WebApplicationException或者其他自定义异常，这时候JAX-RS会优先处理外层的异常，而不会走到你的Mapper里。

建议在抛出异常的地方打个断点，确认实际抛出的异常类型和你Mapper处理的类型完全一致。

3. 存在优先级更高的ExceptionMapper #

如果项目里还有其他@Provider注解的ExceptionMapper，比如处理Exception或者RuntimeException的通用Mapper，JAX-RS会选择最具体的那个，但如果有其他Mapper先被注册或者优先级更高，可能会覆盖你的实现。

排查方法：搜索项目里所有的ExceptionMapper实现类，看看有没有和你处理同类型异常的，或者处理更宽泛父类异常的Mapper。

4. JAX-RS框架未正确扫描或注册你的Mapper #

如果是Spring Boot整合JAX-RS（比如Jersey或RESTeasy），还要确保你的Mapper在框架的扫描路径下，或者手动注册到Application类中：

比如用Jersey的话，你的Application类可以手动注册Mapper：

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

@ApplicationPath("/api")
public class MyJaxRsApplication extends Application {
    @Override
    public Set<Class<?>> getClasses() {
        Set<Class<?>> classes = new HashSet<>();
        classes.add(PortalExceptionMapper.class); // 手动添加你的Mapper
        // 其他需要注册的资源类也加在这里
        return classes;
    }
}

如果是RESTeasy，确保你的配置类里开启了组件扫描，或者用@RegisterProvider注解手动注册。

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