Spring Boot控制器示例为何大多不捕获异常？是否遗漏核心概念？

这不是遗漏了Spring Boot的核心概念，反而恰恰是利用了Spring Boot提供的全局异常处理机制，让代码更简洁、职责更清晰。以下是具体原因：

1. Spring Boot自带全局异常处理能力 #

Spring Boot通过@ControllerAdvice（或@RestControllerAdvice）和@ExceptionHandler注解，支持全局统一处理异常，不需要在每个Controller里重复编写try/catch代码。

这种机制可以把异常处理从业务代码中剥离出来，作为横切关注点统一管理——不管哪个Controller抛出异常，都会被全局处理器捕获，统一完成日志记录、错误响应格式化等操作。

2. 遵循单一职责原则 #

Controller的核心职责是接收请求、调用业务服务、返回响应，如果在每个方法里都加try/catch，会让Controller代码臃肿不堪，违背了“单一职责”的设计原则。

把异常处理交给全局处理器，能让Controller代码更聚焦于业务逻辑，可读性和维护性更强。

3. 示例的简洁性需求 #

多数示例的目的是展示Controller的核心用法（比如请求映射、参数绑定、响应返回），如果加入异常处理代码，会分散读者的注意力，反而不利于理解核心逻辑。所以示例通常会省略通用的异常处理部分，只保留最关键的业务代码。

结合你的场景的优化方案 #

你的团队需要捕获多数据源、外部服务的异常并记录日志，同时要给4种客户端返回规范的错误响应，用全局异常处理器是最优解，比在每个Controller加try/catch更高效：

全局异常处理器示例代码 #

import lombok.extern.slf4j.Slf4j;
import org.springframework.dao.DataAccessException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.client.RestClientException;

import java.sql.SQLException;

@RestControllerAdvice
@Slf4j
public class GlobalExceptionHandler {

    // 捕获数据库相关异常（多数据源场景适用）
    @ExceptionHandler({SQLException.class, DataAccessException.class})
    public ResponseEntity<ErrorResponse> handleDatabaseExceptions(Exception ex) {
        log.error("数据库操作异常", ex);
        ErrorResponse error = new ErrorResponse("DB_ERROR_001", "数据库服务异常，请稍后重试");
        return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR);
    }

    // 捕获外部Web服务调用异常
    @ExceptionHandler(RestClientException.class)
    public ResponseEntity<ErrorResponse> handleExternalServiceExceptions(RestClientException ex) {
        log.error("外部服务调用异常", ex);
        ErrorResponse error = new ErrorResponse("SERVICE_ERROR_001", "依赖服务暂时不可用，请稍后重试");
        return new ResponseEntity<>(error, HttpStatus.SERVICE_UNAVAILABLE);
    }

    // 捕获自定义业务异常
    @ExceptionHandler(MiscException.class)
    public ResponseEntity<ErrorResponse> handleCustomBusinessExceptions(MiscException ex) {
        log.error("业务异常: {}", ex.getMessage(), ex);
        ErrorResponse error = new ErrorResponse("BUSINESS_ERROR_001", ex.getMessage());
        return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
    }

    // 兜底捕获所有未处理的异常
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleGeneralExceptions(Exception ex) {
        log.error("系统未知异常", ex);
        ErrorResponse error = new ErrorResponse("UNKNOWN_ERROR_001", "系统异常，请联系管理员");
        return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

// 标准化错误响应体（给客户端统一的格式）
class ErrorResponse {
    private String errorCode;
    private String message;

    // 构造方法、getter/setter 按需实现
    public ErrorResponse(String errorCode, String message) {
        this.errorCode = errorCode;
        this.message = message;
    }

    public String getErrorCode() {
        return errorCode;
    }

    public void setErrorCode(String errorCode) {
        this.errorCode = errorCode;
    }

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }
}

这个方案的优势 #

• 代码复用：不用在每个Controller写重复的try/catch，所有异常统一处理
• 日志集中：所有异常日志都在一个地方记录，方便排查问题
• 响应规范：给所有客户端返回统一格式的错误响应，避免不同Controller返回不同格式的错误信息
• 扩展性强：后续新增异常类型，只需要在全局处理器里加一个@ExceptionHandler方法即可

你的思路（捕获异常、记录日志、返回友好错误）是完全正确的，只是Spring Boot提供了更优雅的实现方式，不需要在Controller里重复造轮子。

内容的提问来源于stack exchange，提问作者CuriousGeo66