Java全局异常处理方法与应用

一分耕耘，一分收获！既然打开了这篇文章《Java全局异常处理机制详解》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

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

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

定义全局异常处理器类

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

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

设计统一响应结构

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

• Result：含code（如200成功、500系统异常、400参数错误）、msg（提示语）、data（业务数据）
• 异常处理器里不再return new ModelAndView，而是return Result.fail("操作失败", e.getMessage())
• 前端统一判断code，无需解析不同字段，也便于后续做国际化或错误码映射

分层捕获与日志记录

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

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

补充：WebMvcConfigurer与异常页面（可选）

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

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

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

到这里，我们也就讲完了《Java全局异常处理方法与应用》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！