Java全局异常处理与错误响应方案

本文深入讲解了在Spring Boot应用中如何通过@ControllerAdvice与@ExceptionHandler构建健壮、统一的全局异常处理机制：从捕获各类异常（包括空指针、越界及自定义业务异常）到定义标准化JSON错误响应结构，再到结合SLF4J日志记录实现问题可追溯，全面提升系统的稳定性、可维护性与前后端协作效率——无论你是初学者还是经验开发者，掌握这套实践方案都能让你的Java Web接口更专业、更可靠。

在Java开发中，特别是使用Spring Boot框架时，全局异常处理是提升系统健壮性和接口一致性的关键环节。通过全局异常处理器，可以统一捕获未处理的异常，并返回格式化的错误响应，避免将原始错误暴露给前端。

使用@ControllerAdvice和@ExceptionHandler实现全局异常处理

Spring提供了一个注解 @ControllerAdvice，它可以配合 @ExceptionHandler 来定义一个全局的异常处理器。这个类会拦截所有控制器中抛出的异常。

示例：定义全局异常处理类

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org新春.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

@ControllerAdvice
public class GlobalExceptionHandler {

    // 处理空指针异常
    @ExceptionHandler(NullPointerException.class)
    public ResponseEntity handleNullPointerException(NullPointerException e) {
        ErrorResponse error = new ErrorResponse("空值异常", e.getMessage());
        return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR);
    }

    // 处理数组越界
    @ExceptionHandler(IndexOutOfBoundsException.class)
    public ResponseEntity handleIndexOutOfBoundsException(IndexOutOfBoundsException e) {
        ErrorResponse error = new ErrorResponse("索引越界", e.getMessage());
        return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
    }

    // 处理自定义业务异常
    @ExceptionHandler(BusinessException.class)
    public ResponseEntity handleBusinessException(BusinessException e) {
        ErrorResponse error = new ErrorResponse("业务异常", e.getMessage());
        return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
    }

    // 捕获其他未预期的异常
    @ExceptionHandler(Exception.class)
    public ResponseEntity handleGeneralException(Exception e) {
        ErrorResponse error = new ErrorResponse("系统错误", "服务器内部错误，请稍后重试");
        return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

定义统一的错误响应结构

public class ErrorResponse {
    private String error;
    private String message;

    public ErrorResponse(String error, String message) {
        this.error = error;
        this.message = message;
    }

    // getter 和 setter 省略，实际项目中需要加上
}

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

为了更清晰地区分不同类型的错误，建议定义自己的业务异常类，比如 BusinessException，这样可以在代码中主动抛出并被全局处理器捕获。

public class BusinessException extends RuntimeException {
    public BusinessException(String message) {
        super(message);
    }
}

在服务中使用：

```java if (user == null) { throw new BusinessException("用户不存在"); } ```

结合日志记录便于排查问题

全局异常处理不仅要返回友好提示，还应记录详细日志，方便后续排查。可在每个处理方法中加入日志输出。

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

@ControllerAdvice
public class GlobalExceptionHandler {
    private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    @ExceptionHandler(Exception.class)
    public ResponseEntity handleGeneralException(Exception e) {
        logger.error("未捕获异常：", e);  // 记录堆栈信息
        ErrorResponse error = new ErrorResponse("系统错误", "服务器内部错误，请联系管理员");
        return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

支持返回JSON格式错误（适用于前后端分离）

现代Web应用通常要求返回JSON格式的错误信息。@ControllerAdvice 默认支持返回对象，Spring会自动将其序列化为JSON（前提是引入了Jackson等依赖）。

确保 pom.xml 中有：

```xml org.springframework.bootspring-boot-starter-web ```

该依赖已包含Jackson，因此返回的 ErrorResponse 会自动转为JSON。

基本上就这些。合理使用全局异常处理器能让系统更稳定、接口更规范。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~