Java如何统一处理异常_Java全局异常处理机制搭建指南-java教程-PHP中文网

Java如何统一处理异常_Java全局异常处理机制搭建指南

P粉602998670

发布： 2025-12-08 19:31:26

原创

563人浏览过

Java统一异常处理核心是@ControllerAdvice配合@ExceptionHandler，结合统一响应格式Result和分级日志记录，实现异常拦截、分类处理与友好返回。

java如何统一处理异常_java全局异常处理机制搭建指南

Java中统一处理异常的核心是用@ControllerAdvice配合@ExceptionHandler，再结合统一响应格式和日志记录，让所有控制器的运行时异常都能被拦截、分类、友好返回，避免堆栈暴露给前端。

新建一个类，加上@ControllerAdvice注解，它会自动作用于所有@Controller（包括@RestController）：

类上加@ControllerAdvice，可指定包路径（如basePackages = "com.example.controller"）缩小生效范围
方法上用@ExceptionHandler声明能捕获的异常类型，支持多个异常类，如@ExceptionHandler({NullPointerException.class, IllegalArgumentException.class})
方法参数可直接写异常对象、HttpServletRequest、HttpServletResponse等，Spring会自动注入

避免每个接口返回Map或Object，建议封装一个标准响应体，比如：

不是所有异常都该被全局处理器“吞掉”，要区分场景：

SONIFY.io

设计和开发音频优先的产品和数据驱动的解决方案

业务异常（如UserNotExistException）——建议自定义异常并主动throw，由@ExceptionHandler精准捕获，返回400或特定code
系统异常（如NullPointerException、SQLException）——兜底捕获Exception，记录ERROR日志（含堆栈），返回500 + 友好提示（如“服务暂时不可用”）
使用log.error("全局异常捕获", e)，确保堆栈完整入库，方便排查

如果项目还用JSP/Thymeleaf渲染页面，可额外配置：

实现WebMvcConfigurer，重写configureHandlerExceptionResolvers()，添加SimpleMappingExceptionResolver
为不同异常映射到不同错误页（如404.html、500.html），但REST API项目通常不需要
注意：@ControllerAdvice优先级高于SimpleMappingExceptionResolver，两者不冲突，前者更灵活

基本上就这些。不复杂但容易忽略的是日志记录粒度和响应code的合理性——别让500满天飞，也别把业务错误全塞进200里返回错误信息。

以上就是Java如何统一处理异常_Java全局异常处理机制搭建指南的详细内容，更多请关注php中文网其它相关文章！