Spring Boot中如何用HandlerInterceptorAdapter的postHandle处理并拦截异常？

首先得明确：你用HandlerInterceptorAdapter的postHandle方法根本没法捕获Controller层抛出的异常——当Controller方法抛出异常时，Spring的异常处理机制会直接接管，拦截器的postHandle方法甚至不会被执行，自然也没法拦截或忽略异常。

正确的解决方案：全局异常处理器（@ControllerAdvice + @ExceptionHandler） #

这是Spring Boot官方推荐的全局异常处理方案，能精准捕获所有Controller层抛出的异常，并且完全自定义处理逻辑（包括忽略异常、返回自定义响应）。

代码实现示例 #

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@ControllerAdvice
public class GlobalExceptionHandler {
    private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    // 捕获所有类型的异常，你也可以指定具体异常（比如RuntimeException、NullPointerException）
    @ExceptionHandler(Exception.class)
    public void handleAllExceptions(Exception ex, HttpServletResponse response) throws IOException {
        // 先记录异常日志（可选）
        log.error("捕获到请求异常: ", ex);

        // 如果要"忽略"异常（不让客户端看到异常信息），可以返回一个正常状态码或自定义响应
        response.setStatus(HttpServletResponse.SC_OK);
        response.setContentType("application/json;charset=UTF-8");
        response.getWriter().write("{\"code\":200,\"msg\":\"请求已处理（异常已忽略）\"}");
    }
}

代码说明 #

• @ControllerAdvice：标记这个类为全局异常处理器，会作用于所有Controller。
• @ExceptionHandler(Exception.class)：指定要捕获的异常类型，这里是所有Exception子类，你可以根据需求缩小范围（比如只处理业务异常）。
• 在方法内，你可以自由控制响应：比如返回200状态码、自定义JSON响应，这样客户端就看不到原始异常了，相当于"忽略"了异常。

为什么你的Interceptor实现没生效？ #

补充下拦截器的执行逻辑：
拦截器的执行顺序是：preHandle → Controller方法执行 → postHandle → afterCompletion。
但如果Controller方法抛出异常，postHandle会被直接跳过，只会执行afterCompletion方法。而且此时响应已经开始构建，你无法再修改响应内容来"忽略"异常，最多只能记录日志：

@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
    if (ex != null) {
        log.error("请求 {} 抛出异常: ", request.getRequestURI(), ex);
        // 这里无法阻止异常返回给客户端，因为响应已经发送
    }
}

所以拦截器并不适合用来捕获和忽略异常，它的定位是做请求日志、权限校验这类通用前置/后置处理。

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