如何编写Java方法统一处理应用中的异常情况？

本文共计595个文字，预计阅读时间需要3分钟。

在Java中，可以使用以下代码创建一个简单的类：

使用@ControllerAdvice处理全局异常

Spring提供了@ControllerAdvice注解，用于定义全局异常处理器。它能捕获所有控制器中抛出的异常，实现统一响应格式。

常见做法是创建一个异常处理类：

• 用@ControllerAdvice标注类，使其生效于所有Controller
• 使用@ExceptionHandler注解方法，指定处理的异常类型
• 返回统一格式的数据，如JSON错误信息

例如：

立即学习“Java免费学习笔记（深入）”；

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public ResponseEntity<Map<String, Object>> handleException(Exception e) {
        Map<String, Object> response = new HashMap<>();
        response.put("error", e.getMessage());
        response.put("timestamp", System.currentTimeMillis());
        return ResponseEntity.status(500).body(response);
    }
}

自定义业务异常增强可读性

系统内置异常难以表达业务含义。建议定义自己的异常类，比如BusinessException，便于区分技术异常和业务规则异常。

• 继承RuntimeException，避免强制捕获
• 添加错误码字段，方便前端识别处理
• 构造函数支持传入消息和参数

这样在业务逻辑中可以直接抛出有意义的异常，由全局处理器统一拦截并返回结构化信息。

结合日志记录提高排查效率

异常发生时，仅返回用户提示不够。应在全局处理器中加入日志输出，帮助开发定位问题。

推荐使用SLF4J或Logback，在handle方法中记录异常堆栈：

logger.error("Unexpected error: ", e);

注意敏感信息脱敏，避免将数据库细节或内部路径暴露给客户端。

对特定异常做差异化处理

不同异常应有不同响应策略。可以在同一个类中编写多个@ExceptionHandler方法。

• 处理NullPointerException时返回400
• 权限异常返回403
• 资源未找到返回404

也可以捕获自定义异常并提取错误码，返回对应的国际化消息。

基本上就这些。合理使用@ControllerAdvice配合自定义异常和日志，能让Java应用的异常处理更整洁高效。