Spring Boot全局异常处理保姆级教程从入门到实战(看完秒懂)

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Result<T> {
    private Integer code;  // 状态码（200=成功，400=参数错误，500=系统错误）
    private String msg;    // 提示信息
    private T data;        // 业务数据（可选）
    // 快速构建成功响应（带数据）
    public static <T> Result<T> success(T data) {
        return new Result<>(200, "操作成功", data);
    }
    // 快速构建失败响应（自定义code和msg）
    public static <T> Result<T> error(Integer code, String msg) {
        return new Result<>(code, msg, null);
    }
}

// 自定义业务异常（继承RuntimeException，方便在Service层抛出）
public class BusinessException extends RuntimeException {
    private Integer code;  // 业务错误码（如4001=用户不存在）
    public BusinessException(Integer code, String msg) {
        super(msg);
        this.code = code;
    }
    public Integer getCode() {
        return code;
    }
}

@RestControllerAdvice
public class GlobalExceptionHandler {
    // 处理业务异常（比如用户不存在）
    @ExceptionHandler(BusinessException.class)
    public Result<?> handleBusinessException(BusinessException e) {
        return Result.error(e.getCode(), e.getMessage());
    }
}

// 全局处理参数校验异常（@RequestBody参数校验失败）
@ExceptionHandler(MethodArgumentNotValidException.class)
public Result<?> handleValidationException(MethodArgumentNotValidException e) {
    // 提取所有校验失败的字段信息（比如"用户名不能为空"）
    String errorMsg = e.getBindingResult().getFieldErrors().stream()
            .map(FieldError::getDefaultMessage)
            .collect(Collectors.joining("；"));
    return Result.error(400, "参数校验失败：" + errorMsg);
}

// 全局处理其他未捕获的异常（系统级错误）
@ExceptionHandler(Exception.class)
public Result<?> handleSystemException(Exception e) {
    // 记录完整异常堆栈（生产环境必加！）
    log.error("系统发生未知异常，请求路径：{}", getRequestPath(), e);
    // 返回友好提示（前端看到的是"服务器繁忙，请稍后再试"）
    return Result.error(500, "服务器繁忙，请稍后再试");
}
// 辅助方法：获取当前请求路径（需要spring-web依赖）
private String getRequestPath() {
    ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
    return attributes == null ? "" : attributes.getRequest().getRequestURI();
}

@Service
public class UserService {
    public User getUserById(Long id) {
        // 模拟数据库查询（假设id=100的用户不存在）
        User user = null; 
        if (user == null) {
            throw new BusinessException(4001, "用户ID=" + id + "不存在"); // 抛业务异常
        }
        return user;
    }
}
@RestController
@RequestMapping("/users")
public class UserController {
    @Autowired
    private UserService userService;
    @GetMapping("/{id}")
    public Result<User> getUser(@PathVariable Long id) {
        User user = userService.getUserById(id);
        return Result.success(user); // 正常返回
    }
}

// 自定义异常（标记为404状态码）
@ResponseStatus(HttpStatus.NOT_FOUND) 
public class ResourceNotFoundException extends RuntimeException {
    public ResourceNotFoundException(String msg) {
        super(msg);
    }
}
// 全局处理（可选，也可以直接用@ResponseStatus）
@ExceptionHandler(ResourceNotFoundException.class)
public Result<?> handleResourceNotFound(ResourceNotFoundException e) {
    return Result.error(404, e.getMessage());
}

@ExceptionHandler(BindException.class)
public Result<?> handleBindException(BindException e) {
    String errorMsg = e.getBindingResult().getFieldErrors().stream()
            .map(FieldError::getDefaultMessage)
            .collect(Collectors.joining("；"));
    return Result.error(400, "参数校验失败：" + errorMsg);
}

@ExceptionHandler(Exception.class)
public Result<?> handleSystemException(Exception e) {
    // 获取请求路径
    String path = getRequestPath();
    // 获取用户ID（假设从Token中解析）
    String userId = SecurityUtils.getCurrentUserId(); 
    // 记录日志（包含关键上下文信息）
    log.error("系统异常 | 用户ID={} | 路径={} | 异常信息={}", 
              userId, path, e.getMessage(), e); 
    return Result.error(500, "服务器繁忙，请稍后再试");
}