使用@ControllerAdvice和@ExceptionHandler实现全局异常处理，结合自定义异常类（如BusinessException）和@ResponseStatus注解，统一管理Controller层异常，提升代码可维护性与接口一致性。
在Java后端开发中，处理Controller层的全局异常通常使用 @ControllerAdvice 和 @ExceptionHandler 注解来实现统一异常管理。这种方式可以避免在每个Controller中重复写异常捕获逻辑，提升代码可维护性。
1. 使用 @ControllerAdvice 统一处理异常
@ControllerAdvice 是一个全局异常处理器注解，作用于整个应用的所有Controller。它会拦截所有Controller抛出的未处理异常。
创建一个全局异常处理类：
@ControllerAdvicepublic class GlobalExceptionHandler { @ExceptionHandler(Exception.class) public ResponseEntity handleGenericException(Exception e) { return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR) .body("系统内部错误：" + e.getMessage()); } @ExceptionHandler(NullPointerException.class) public ResponseEntity<Map> handleNPE(NullPointerException e) { Map response = new HashMap(); response.put("error", "空指针异常"); response.put("message", e.getMessage()); return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(response); }}
2. 自定义业务异常并处理
实际项目中建议定义自己的业务异常类，比如 BusinessException，便于区分系统异常和业务逻辑异常。
立即学习“Java免费学习笔记（深入）”；
定义自定义异常：
闪念贝壳
闪念贝壳是一款AI 驱动的智能语音笔记，随时随地用语音记录你的每一个想法。
218 查看详情 
public class BusinessException extends RuntimeException { public BusinessException(String message) { super(message); }}
在 Controller 中抛出：
@GetMapping("/user/{id}")public User getUser(@PathVariable Long id) { if (id <= 0) { throw new BusinessException("用户ID不合法"); } // ...}
在全局处理器中添加对应处理方法：
@ExceptionHandler(BusinessException.class)public ResponseEntity<Map> handleBizException(BusinessException e) { Map response = new HashMap(); response.put("code", 400); response.put("error", "业务异常"); response.put("message", e.getMessage()); return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(response);}
3. 结合 @ResponseStatus 返回标准HTTP状态码
对于某些已知异常，可以直接用 @ResponseStatus 指定返回的状态码，简化响应逻辑。
例如：
@ResponseStatus(HttpStatus.NOT_FOUND)public class ResourceNotFoundException extends RuntimeException { public ResourceNotFoundException(String message) { super(message); }}
当抛出 ResourceNotFoundException 时，自动返回 404 状态码，无需在 handler 中额外设置。基本上就这些。通过组合使用 @ControllerAdvice、@ExceptionHandler 和自定义异常，就能实现清晰、统一的Controller层异常处理机制，既保证接口返回格式一致，又方便前端解析错误信息。
以上就是java后端开发怎么处理Controller层的全局异常？的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/987750.html
微信扫一扫 
支付宝扫一扫 
![linux系统下codeblocks控制台打印中文乱码[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175245629895736.jpg)
![linux系统下codeblocks控制台打印中文乱码[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175245629849970.jpg)
![linux系统下codeblocks控制台打印中文乱码[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175245629946891.jpg)
![linux系统下codeblocks控制台打印中文乱码[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175245629944402.jpg)
