Java 自定义异常怎么在限流降级时返回特定错误-java教程-PHP中文网

限流时需主动抛出自定义异常并由全局处理器统一响应，而非依赖框架自动包装；sentinel中捕获blockexception后转为ratelimitexception，再通过@controlleradvice返回429 json格式错误；降级应在fallback中直接返回兜底结果，避免抛异常；网关层限流更优，可直接返回429而不进入服务。

java 自定义异常怎么在限流降级时返回特定错误

在限流降级场景中，Java 自定义异常本身不会自动“返回特定错误”，关键在于你如何在限流触发时主动抛出该异常，并在统一异常处理层将其转化为前端友好的响应（如 JSON 错误码 + 提示）。

限流时主动抛出自定义异常

不要依赖框架“自动包装”你的异常。以 Sentinel 为例，在资源被限流时，默认抛出 BlockException。你需要用 try-catch 捕获它，并立即抛出你自己的业务异常（如 RateLimitException）：

定义自定义异常（继承 RuntimeException 即可，无需 checked）：

  public class RateLimitException extends RuntimeException {
    private final int code = 429;
    private final String message = "请求过于频繁，请稍后再试";

    public RateLimitException() { super("rate limit exceeded"); }
  }

在 Sentinel 资源入口处捕获并转换：

  @SentinelResource(value = "userQuery", blockHandler = "handleBlock")
  public Result queryUser(Long id) {
    return userService.getById(id);
  }

  public Result handleBlock(Long id, BlockException ex) {
    throw new RateLimitException(); // 主动抛出你的异常
  }

全局异常处理器统一响应格式

Spring Boot 中用 @ControllerAdvice 拦截你的自定义异常，返回标准 JSON 结构：

  @ExceptionHandler(RateLimitException.class)
  @ResponseStatus(HttpStatus.TOO_MANY_REQUESTS)
  @ResponseBody
  public Result handleRateLimit(RateLimitException e) {
    return Result.fail(429, e.getMessage()); // 如 {"code":429,"msg":"请求过于频繁...","data":null}
  }

这样前端收到的就是明确的 429 状态码和可解析的业务错误信息，而非默认的 HTML 错误页或空响应。