Spring Boot中@PathParam校验不通过时@ExceptionHandler未触发问题

从你的描述和栈信息来看，异常处理方法未被调用主要有以下几个可能的原因，对应解决办法如下：

1. SDK自带的异常拦截器抢先捕获了异常 #

从栈追踪可以看到，ConstraintViolationException抛出后，会经过Spring的AOP调用链，最终到达com.ncr.nep.sdk.service.aspect.ExceptionInterceptor——这个SDK内置的拦截器很可能已经捕获了所有异常（包括ConstraintViolationException），并将其转换为通用服务异常或者直接返回了500响应，导致你的自定义异常处理器根本没机会接触到原异常。

解决办法：

• 查看SDK的文档或源码，确认ExceptionInterceptor是否支持配置排除特定异常类型，让ConstraintViolationException可以继续向上传播到你的异常处理器。
• 调整AOP拦截器的执行顺序：通过设置@Order注解，让Spring的MethodValidationInterceptor（对应MethodValidationPostProcessor）在SDK的ExceptionInterceptor之后执行。你可以给methodValidationPostProcessor方法添加@Order(Ordered.HIGHEST_PRECEDENCE)或者调整优先级，确保参数验证异常在SDK拦截器之后抛出，避免被提前捕获。

2. 控制器内的@ExceptionHandler无法捕获方法调用前的AOP异常 #

你把@ExceptionHandler定义在控制器类内部，这种情况下它只能捕获该控制器方法执行过程中抛出的异常。而ConstraintViolationException是由MethodValidationInterceptor在控制器方法调用之前（参数验证阶段）抛出的，属于控制器方法执行流程外的异常，因此无法被控制器内的异常处理器捕获。

解决办法：
将异常处理逻辑移到全局异常处理类中，使用@RestControllerAdvice（全局生效的REST控制器异常处理）来捕获这类全局异常：

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import javax.validation.ConstraintViolationException;
import java.util.Set;

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(value = { ConstraintViolationException.class }) 
    @ResponseStatus(value = HttpStatus.BAD_REQUEST) 
    public String handleConstraintViolationException(ConstraintViolationException e) { 
        Set<javax.validation.ConstraintViolation<?>> violations = e.getConstraintViolations(); 
        StringBuilder strBuilder = new StringBuilder(); 
        for (javax.validation.ConstraintViolation<?> violation : violations ) { 
            strBuilder.append(violation.getMessage() + "\n"); 
        } 
        return strBuilder.toString(); 
    }
}

3. JAX-RS与Spring MVC异常处理机制不兼容 #

你的接口使用的是JAX-RS的@GET、@Path注解，而Spring的@ExceptionHandler是为Spring MVC（@GetMapping、@RequestMapping系列注解）设计的。如果你的应用是基于JAX-RS（比如集成了Jersey或RESTEasy），Spring MVC的异常处理机制不会自动处理JAX-RS端点抛出的异常。

解决办法：
使用JAX-RS原生的ExceptionMapper来处理异常：

import javax.ws.rs.core.Response;
import javax.ws.rs.ext.ExceptionMapper;
import javax.ws.rs.ext.Provider;
import javax.validation.ConstraintViolationException;
import java.util.Set;

@Provider
public class ConstraintViolationExceptionMapper implements ExceptionMapper<ConstraintViolationException> {
    @Override
    public Response toResponse(ConstraintViolationException e) {
        Set<javax.validation.ConstraintViolation<?>> violations = e.getConstraintViolations();
        StringBuilder strBuilder = new StringBuilder();
        for (javax.validation.ConstraintViolation<?> violation : violations ) {
            strBuilder.append(violation.getMessage() + "\n");
        }
        return Response.status(Response.Status.BAD_REQUEST)
                .entity(strBuilder.toString())
                .build();
    }
}

将这个类注册为Spring Bean（比如添加@Component注解），或者在JAX-RS的配置类中手动注册该ExceptionMapper。

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