在构建Java应用程序（尤其是使用Spring Boot等框架时），开发者很容易忽视正确的异常处理。不过，管理不善的异常会使应用更难调试、更难以维护，对处理生产问题的人员来说更是噩梦。

本文将探讨如何通过以下方式实现高效异常处理：
✅ 避免泛化catch块
✅ 使用自定义异常
✅ 通过Spring Boot的@ControllerAdvice聚焦处理异常

让我们深入解析。

---

泛化catch块的弊端

常见错误示例：

try {
    // 风险代码
} catch (Exception e) {
    e.printStackTrace(); // 在生产环境中毫无价值！
}

这种”一刀切”的方式存在严重问题：

1. 掩盖真实问题：捕获Exception可能隐藏需要关注的深层Bug
2. 调试困难：仅打印堆栈跟踪无法提供生产环境所需的上下文
3. 缺乏针对性：泛化处理使错误根源难以定位

---

解决方案

捕获具体异常类型：

try {
    // 风险操作
} catch (IOException e) {  // 明确指定异常类型
    log.error("文件读取错误：" + e.getMessage());  // 记录完整日志
    // 针对性处理IO异常
}

通过捕获IOException，可快速定位输入/输出相关问题。

---

创建自定义异常

当标准异常无法满足业务逻辑时，自定义异常是更优选择。
优势：

• 业务语义化：异常名称直接体现业务场景
• 精准控制：针对不同场景定制处理逻辑

示例：用户查找异常

public class UserNotFoundException extends RuntimeException {
    public UserNotFoundException(String userId) {
        super("用户不存在：" + userId);  // 携带业务上下文
    }
}

业务层使用：

User user = userRepository.findById(id)
    .orElseThrow(() -> new UserNotFoundException(id));  // 抛出业务异常

---

聚焦异常处理：@ControllerAdvice

Spring Boot的@ControllerAdvice提供全局异常处理能力：

@RestControllerAdvice
public class GlobalExceptionHandler {
    
    // 处理自定义业务异常
    @ExceptionHandler(UserNotFoundException.class)
    public ResponseEntity<String> handleUserNotFound(UserNotFoundException ex) {
        return new ResponseEntity<>(ex.getMessage(), HttpStatus.NOT_FOUND);
    }
    
    // 兜底异常处理
    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleAll(Exception ex) {
        return new ResponseEntity<>("系统内部错误", HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

核心价值：

• 消除Controller层的重复异常处理代码
• 统一错误响应格式
• 隔离业务逻辑与错误处理

---

结构化错误响应

定义标准错误DTO：

public class ErrorResponse {
    private String message;      // 错误信息
    private int status;          // HTTP状态码
    private LocalDateTime timestamp; // 时间戳
    
    // 构造器/getter/setter
}

在ControllerAdvice中使用：

@ExceptionHandler(UserNotFoundException.class)
public ResponseEntity<ErrorResponse> handleUserNotFound(UserNotFoundException ex) {
    ErrorResponse error = new ErrorResponse(
        ex.getMessage(), 
        HttpStatus.NOT_FOUND.value(), 
        LocalDateTime.now()
    );
    return new ResponseEntity<>(error, HttpStatus.NOT_FOUND);
}

响应示例：

json

{
  "message": "用户不存在：U12345",
  "status": 404,
  "timestamp": "2023-08-15T14:30:00"
}

---

异常处理最佳实践

1. 记录完整上下文
2. java
3. 复制代码
4. log.error(“用户查询失败 – ID: {}, 错误: {}”, userId, e.getMessage());
5. 敏感信息防护生产环境禁止返回堆栈跟踪避免暴露数据库结构等内部信息
6. 精准使用HTTP状态码404：资源不存在400：请求参数错误401/403：认证/权限问题500：服务器内部错误

---

结语

高效的异常处理是构建健壮应用的核心：
用具体异常捕获替代catch(Exception e)
通过自定义异常传递业务语义
利用 @ControllerAdvice 统一处理流程
结构化错误响应提升调试效率