梳理Spring Boot中三种异常处理

在 Spring Boot 中处理异常确实有多个方式,比如使用 @ControllerAdviceBasicErrorControllerHandlerExceptionResolver等。不同方式适合不同的场景,下面是对这些方式的分析以及如何选择的建议:

🧩 1. @ControllerAdvice + @ExceptionHandler(推荐使用)

适用场景:

• 适合全局或局部地处理控制器抛出的异常。

• 适合为 REST 接口返回统一的异常结构(如 JSON)。

优点:

• 使用简单,语义明确。

• 可细粒度控制不同异常的处理逻辑。

• 与 Spring MVC 集成紧密,配合@ResponseStatus等注解效果更好。

示例:

java 复制代码
@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ResourceNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ErrorResponse handleNotFound(ResourceNotFoundException ex) {
        return new ErrorResponse("NOT_FOUND", ex.getMessage());
    }

    @ExceptionHandler(Exception.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public ErrorResponse handleException(Exception ex) {
        return new ErrorResponse("INTERNAL_ERROR", "Unexpected error occurred");
    }
}

🧩 2. 自定义 BasicErrorController

适用场景:

• 需要完全控制 Spring Boot 默认错误响应行为时。

• 通常用于构建统一错误页面(HTML)或更底层的 JSON 错误处理逻辑。

优点:

• 可以替换 Spring Boot 默认的 /error 映射逻辑。

• 对 WebMvc + REST + WebFlux 一致性要求高时有用。

缺点:

• 实现复杂,通常不建议自定义它,除非你确实不满意 Spring Boot 提供的默认行为。

备注:

• Spring Boot 默认的错误信息来自 DefaultErrorAttributes 和 BasicErrorController。

🧩 3. HandlerExceptionResolver(低级机制)

适用场景:

• 需要低级别控制异常解析过程,比如处理过滤器/拦截器中抛出的异常。

• 不推荐用于日常业务异常处理。

优点:

• 可用于特殊场景,如非 MVC 层的异常处理。

缺点:

• 更底层、侵入性大、可维护性差。


✅ 选择建议总结

使用方式 场景适合 是否推荐
@ControllerAdvice 统一处理控制器异常(REST 风格),前后端分离 ✅ 推荐
BasicErrorController 自定义 Spring Boot 错误响应入口,有HTML页面需求 ⚠️ 特殊需求时使用
HandlerExceptionResolver 全局底层异常控制 ❌ 不推荐常规使用

总得来说,如果是前后端分离的项目则选择@ControllerAdvice,如果是需要返回HTML错误页面选择BasicErrorController,除非有更底层的异常处理就选择HandlerExceptionResolver,但一般不建议使用。

相关推荐
31535669136 分钟前
ClipReader:一个剪贴板英语单词阅读器
前端·后端
ladymorgana9 分钟前
【Spring Boot】HikariCP 连接池 YAML 配置详解
spring boot·后端·mysql·连接池·hikaricp
kyle~22 分钟前
C/C++字面量
java·c语言·c++
neoooo30 分钟前
别慌,Java只有值传递——一次搞懂“为啥我改了它还不变”!
java·后端·spring
秋难降30 分钟前
Python 知识 “八股”:给有 C 和 Java 基础的你😁😁😁
java·python·c
wuxuanok33 分钟前
Web后端开发-请求响应
java·开发语言·笔记·学习
用户77853718369634 分钟前
一力破万法:从0实现一个http代理池
后端·爬虫
livemetee41 分钟前
spring-ai 1.0.0 (3)交互增强:Advisor 顾问模块
java
DDDDDouble1 小时前
<二>Sping-AI alibaba 入门-记忆聊天及持久化
java·人工智能
拖孩1 小时前
微信群太多,管理麻烦?那试试接入AI助手吧~
前端·后端·微信