定义 ratelimitexception 需要继承 runtimeexception,并保留标准构造函数以支持异常链。具体做法是创建一个类,提供无参构造、带消息的构造以及带原因(cause)的构造方法,这样在捕获限流错误时可以直接抛出或包装底层异常。

如何添加自定义字段存储限流信息
在业务场景中通常需要知道具体的重试时间或剩余配额,因此需要在异常类中定义私有字段并提供 Getter 方法。通过构造函数接收这些参数并赋值,可以在抛出异常时将上下文信息一并传递,方便上层逻辑进行差异化处理。

Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。
public class RateLimitException extends RuntimeException {
private final long retryAfterMs;
public RateLimitException(String message, long retryAfterMs) {
super(message);
this.retryAfterMs = retryAfterMs;
}
public long getRetryAfterMs() {
return retryAfterMs;
}
}如何在代码中抛出该异常
在实际调用限流组件(如 Guava RateLimiter 或 Redis 脚本)失败时,直接实例化 RateLimitException 并抛出即可。如果限流组件本身抛出的是检查型异常或运行时异常,建议将其作为 Cause 传入构造函数,以便保留完整的堆栈跟踪信息。
立即学习“Java免费学习笔记(深入)”;

// 假设有一个限流器对象 rateLimiter
if (!rateLimiter.tryAcquire()) {
throw new RateLimitException("Service busy", 5000);
}
// 或者包装现有异常
try {
redisClient.execute();
} catch (JedisDataException e) {
if (e.getMessage().contains("BUSYKEY")) {
throw new RateLimitException("Redis limit reached", 1000, e);
}
throw e;
}

















