Java 自定义异常怎么在拦截器中返回标准 JSON 响应-java教程-PHP中文网

应使用@controlleradvice+@exceptionhandler统一处理异常并返回标准json响应，拦截器仅负责权限校验等横切逻辑，不可用于捕获控制器内异常；自定义异常需继承runtimeexception，全局处理器按异常类型返回result对象。

java 自定义异常怎么在拦截器中返回标准 json 响应

在 Spring Boot 项目中，自定义异常要在拦截器（Interceptor）中统一返回标准 JSON 响应，**不推荐直接在拦截器里处理异常**——因为拦截器的 preHandle、afterCompletion 等方法无法捕获控制器（Controller）内部抛出的异常（比如 throw new BusinessException("参数错误")），它只负责请求前/后逻辑，不参与异常传播链。

真正可靠、符合 Spring 生态的方式是：**用 @ControllerAdvice + @ExceptionHandler 统一处理自定义异常，并返回标准 JSON 响应**。拦截器只做权限校验、日志记录等事，异常交给全局异常处理器。

✅ 正确做法：用全局异常处理器替代拦截器处理异常

这是 Spring 官方推荐方案，简洁、解耦、可测试性强。

定义自定义异常（如 BusinessException），继承 RuntimeException
编写全局异常处理器类，标注 @ControllerAdvice
为每种异常写 @ExceptionHandler 方法，返回 ResponseEntity<result></result> 或直接返回 Result（配合 @ResponseBody）
确保返回对象（如 Result<t></t>）有标准字段：code、message、data、timestamp

示例：

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

// 自定义异常
public class BusinessException extends RuntimeException {
    private int code = 400;
    public BusinessException(String message) { super(message); }
    public BusinessException(int code, String message) {
        super(message);
        this.code = code;
    }
    // getter...
}

// 全局响应包装类
public class Result<t> {
    private int code;
    private String message;
    private T data;
    private long timestamp = System.currentTimeMillis();
    // 构造方法、getter/setter...
}

// 全局异常处理器
@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(BusinessException.class)
    @ResponseBody
    public Result<void> handleBusinessException(BusinessException e) {
        return Result.fail(e.getCode(), e.getMessage());
    }

    @ExceptionHandler(Exception.class)
    @ResponseBody
    public Result<void> handleOtherException(Exception e) {
        return Result.fail(500, "系统繁忙，请稍后再试");
    }
}
</void></void></t>

⚠️ 如果非要在拦截器里“感知”异常（不推荐但有时需兼容老逻辑）

拦截器本身不能捕获 Controller 抛出的异常，但你可以：

在 afterCompletion(HttpServletRequest, HttpServletResponse, Object, Exception) 方法中拿到第四个参数 Exception
若该异常是你自定义的（如 BusinessException），可在此手动写入 JSON 响应并设置状态码
⚠️ 注意：此时响应体已部分写出，必须先 response.reset()（慎用！易导致响应冲突）；更稳妥的是设标志位，再交由异常处理器兜底

示例（仅作技术说明，生产慎用）：

public class AuthInterceptor implements HandlerInterceptor {
    @Override
    public void afterCompletion(
            HttpServletRequest request,
            HttpServletResponse response,
            Object handler,
            Exception ex) throws Exception {
        if (ex instanceof BusinessException) {
            BusinessException be = (BusinessException) ex;
            response.reset(); // 清空已写内容（风险高！）
            response.setStatus(be.getCode());
            response.setContentType("application/json;charset=UTF-8");
            response.getWriter().write(
                new ObjectMapper().writeValueAsString(
                    Result.fail(be.getCode(), be.getMessage())
                )
            );
        }
    }
}

? 关键提醒

拦截器不是异常处理层，它是横切请求生命周期的工具；异常处理属于“错误语义”范畴，应由 Spring MVC 的异常解析机制接管
使用 @ControllerAdvice 后，所有 @RestController 和 @Controller + @ResponseBody 方法抛出自定义异常都会被自动捕获
如果用了 WebMvcConfigurer 自定义配置，确保没禁用默认的 ExceptionHandlerExceptionResolver
需要区分业务异常（400 类）、认证异常（401）、授权异常（403）、系统异常（500），可在不同 @ExceptionHandler 中分别处理