在spring boot中实现rest接口限流,最推荐的做法是结合redis和lua脚本使用redisson客户端的ratelimiter组件。通过引入redisson-spring-boot-starter依赖,在controller方法上添加@ratelimiter注解并指定key、limit和timeunit参数,即可利用redis原子操作实现分布式令牌桶算法,有效拦截超出阈值的请求。

如何配置Redisson客户端以支持分布式限流
要实现上述功能,首先需要确保项目中引入了正确的依赖,并正确配置了Redis连接信息。Redisson提供了对Spring Boot的良好支持,只需在pom.xml中添加依赖,并在application.yml中配置Redis地址即可。配置完成后,Spring容器会自动创建RedissonClient Bean,供后续限流器使用。

<dependency>
<groupId>org.redisson</groupId>
<artifactId>redisson-spring-boot-starter</artifactId>
<version>3.27.0</version>
</dependency>
spring:
redis:
host: localhost
port: 6379
password: your_password
配置完成后,可以在Service或Controller层注入RLimitter实例。例如,创建一个名为userLoginLimiter的限流器,限制每个用户每分钟最多登录5次。当请求到达时,如果令牌不足,限流器会直接抛出异常或返回false,从而阻止业务逻辑执行。
@RestController
public class LoginController {
@Autowired
private RedissonClient redissonClient;
@GetMapping("/login")
public String login(@RequestParam String username) {
RRateLimiter rateLimiter = redissonClient.getRateLimiter("login_limiter:" + username);
// 尝试获取一个令牌,等待时间0秒
boolean available = rateLimiter.tryAcquire(1, 0, TimeUnit.SECONDS);
if (!available) {
throw new RuntimeException("请求过于频繁,请稍后再试");
}
return "登录成功";
}
}
运行该程序,当同一用户短时间内发起多次请求时,第6次请求将触发异常。预期结果是前5次请求正常返回“登录成功”,第6次及之后的请求抛出RuntimeException。这验证了基于用户ID的限流策略生效。
如何自定义限流器的容量与速率参数
在实际场景中,不同的接口可能需要不同的限流策略。例如,查询接口可以允许较高的并发,而写接口则需要严格限制。Redisson的RateLimiter支持动态设置总容量(totalPermits)和速率(rate)。可以通过代码方式初始化限流器,或者在注解中指定参数。对于更复杂的场景,如滑动窗口限流,可以使用Redisson的RRateLimiter配合不同的RateIntervalUnit来实现。
@GetMapping("/query")
public String query() {
RRateLimiter queryLimiter = redissonClient.getRateLimiter("query_limiter");
// 设置每秒允许10个请求,总容量为10
queryLimiter.trySetRate(RateType.OVERALL, 10, 1, RateIntervalUnit.SECONDS);
// 尝试获取令牌
if (queryLimiter.tryAcquire(1)) {
return "查询结果";
} else {
throw new RuntimeException("系统繁忙,请稍后重试");
}
}
此代码展示了如何动态设置限流参数。trySetRate方法用于配置限流器的行为,OVERALL表示所有节点共享同一个限流计数器。如果设置为PER_CLIENT,则每个客户端IP独立计数。运行程序时,若QPS超过10,后续请求将被拒绝。这体现了限流参数的灵活性,可根据业务需求调整。
当限流器未找到时会发生什么
如果在调用getRateLimiter时传入的key不存在,Redisson不会报错,而是会创建一个全新的限流器实例,其默认参数取决于后续调用的setRate或trySetRate方法。如果未显式设置参数,直接使用tryAcquire,可能会因为默认值为0而导致所有请求被拒绝。因此,务必在首次使用时明确设置限流参数,以避免意外行为。


















