使用 @restcontrolleradvice 配合 @exceptionhandler 注解可以捕获方法调用异常。在配置类中定义一个全局异常处理器,针对特定异常类型编写处理方法,该方法返回自定义的响应结构,从而统一拦截并处理所有控制器抛出的异常。

如何捕获运行时异常并返回JSON
通过继承 ResponseEntityExceptionHandler 或直接定义新的异常处理逻辑,可以捕获如 RuntimeException 或自定义业务异常。当控制器方法抛出这些异常时,Spring Boot 会自动将其转发到全局处理器,处理器提取异常信息并封装为 JSON 对象返回给客户端。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(RuntimeException.class)
public ResponseEntity<string> handleRuntimeException(RuntimeException ex) {
return ResponseEntity.status(500).body("Runtime Error: " + ex.getMessage());
}
}</string>
如何处理参数校验失败异常
在处理表单或请求体数据时,若使用 @Valid 注解进行校验,校验失败会抛出 MethodArgumentNotValidException。在全局异常处理器中专门捕获该异常,可以遍历校验错误详情,将它们收集到一个列表中,并以统一的格式返回,避免直接暴露底层校验框架的错误堆栈。

import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import java.util.stream.Collectors;
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<string> handleValidationExceptions(MethodArgumentNotValidException ex) {
String errors = ex.getBindingResult().getFieldErrors().stream()
.map(FieldError::getDefaultMessage)
.collect(Collectors.joining(", "));
return ResponseEntity.badRequest().body(errors);
}</string>
未捕获异常时的默认行为是什么
如果抛出的异常没有被任何 @ExceptionHandler 明确捕获,Spring Boot 会启用默认的 BasicErrorController。此时应用会生成一个包含时间戳、错误状态码和错误消息的 JSON 响应,通常对应 HTTP 500 状态码。开发者可以通过修改 application.properties 中的 server.error.include-message 属性来控制是否在响应中显示详细错误信息。











