spring boot 全局异常处理可以通过在控制器类或配置类上使用 @controlleradvice 注解,并配合 @exceptionhandler(indexoutofboundsexception.class) 方法来捕获索引越界异常。具体做法是定义一个返回 responseentity 的异常处理方法,该方法接收 indexoutofboundsexception 类型的参数,从而拦截所有由数组、列表访问越界或字符串截取越界引发的运行时异常,并返回统一的错误响应。

如何定义全局异常处理器类
定义全局异常处理器需要创建一个普通的 Java 类,并使用 @RestControllerAdvice 或 @ControllerAdvice 注解标记该类。这两个注解的区别在于前者同时包含 @ResponseBody,适用于直接返回 JSON 数据的 RESTful API 场景。在该类中,可以定义多个方法,每个方法使用 @ExceptionHandler 指定要捕获的具体异常类型。对于索引越界异常,只需指定 IndexOutOfBoundsException.class 即可覆盖数组和集合的越界访问。这种方法的优势在于无需在每个 Controller 中重复编写 try-catch 块,实现了关注点分离。

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(IndexOutOfBoundsException.class)
public ResponseEntity<String> handleIndexOutOfBounds(IndexOutOfBoundsException ex) {
return ResponseEntity
.status(HttpStatus.BAD_REQUEST)
.body("索引越界: " + ex.getMessage());
}
}如何在 Controller 中触发并验证该异常
为了验证全局异常处理器的有效性,需要在 Controller 中编写一段会必然引发索引越界异常的代码。通常可以通过访问一个固定长度列表的不存在索引来实现。当请求到达该接口时,Spring MVC 的执行流程会在抛出异常后,自动查找匹配的 @ExceptionHandler 方法。如果找到匹配项,则执行该方法并返回其定义的响应体;如果未找到,则继续向上查找默认的错误处理器。通过这种方式,可以确保任何位置的索引越界都能被统一捕获。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.Arrays;
import java.util.List;
@RestController
public class TestController {
private final List<String> items = Arrays.asList("A", "B", "C");
@GetMapping("/trigger-error")
public String triggerError() {
// 故意访问不存在的索引以触发 IndexOutOfBoundsException
return items.get(10);
}
}索引越界异常捕获后的 HTTP 状态码是什么
在上述实现中,索引越界异常被捕获后,返回的 HTTP 状态码为 400 BAD REQUEST。这是因为索引越界通常是由客户端传递了错误的参数(如负数索引或超出范围的索引)引起的,属于客户端请求错误,而非服务器内部逻辑错误(500)。在 handleIndexOutOfBounds 方法中,通过 .status(HttpStatus.BAD_REQUEST) 显式设置了状态码。这种处理方式符合 RESTful 规范,帮助前端或调用方快速定位问题来源。如果希望返回更详细的错误信息,可以将返回类型改为自定义的 DTO 对象,包含错误码、消息和时间戳等字段。


















