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里返回错误信息。

# ai  # app  # js  # java  # html  # 栈  # 前端  # 处理器  # rest api 

相关栏目： <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 AI推广<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 SEO优化<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 技术百科<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 谷歌推广<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 百度推广<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 网络营销<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 案例网站<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 精选文章<？ｍｕｍａ echo $count; ?> 】