news 2026/4/18 15:13:41

Spring Cloud Gateway 实现API接口细粒度的限流需求

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Spring Cloud Gateway 实现API接口细粒度的限流需求

1. Spring Cloud Gateway 内置的 RequestRateLimiter 过滤器

这是最直接的实现方式:

配置示例

spring:cloud:gateway:routes:-id:users_routeuri:lb://user-servicepredicates:-Path=/api/users/**filters:-name:RequestRateLimiterargs:redis-rate-limiter.replenishRate:30# 每秒补充的令牌数redis-rate-limiter.burstCapacity:30# 令牌桶容量redis-rate-limiter.requestedTokens:1# 每次请求消耗的令牌数key-resolver:"#{@apiKeyResolver}"# 自定义Key解析器

2. 实现自定义的 KeyResolver 进行细粒度控制

@ComponentpublicclassApiKeyResolverimplementsKeyResolver{@OverridepublicMono<String>resolve(ServerWebExchangeexchange){Stringpath=exchange.getRequest().getPath().value();// 针对特定接口配置不同限流规则if(path.equals("/api/users/test1")){returnMono.just("users_test1_limit");}elseif(path.equals("/api/users/test2")){returnMono.just("users_test2_limit");}elseif(path.startsWith("/api/users")){returnMono.just("users_common_limit");}returnMono.just("default_limit");}}

3. 更灵活的多规则限流方案

3.1 使用配置中心动态管理规则

# application.ymlspring:cloud:gateway:routes:-id:dynamic_limiter_routeuri:lb://user-servicepredicates:-Path=/api/**filters:-name:RequestRateLimiterargs:key-resolver:"#{@dynamicKeyResolver}"rate-limiter:"#{@dynamicRateLimiter}"

3.2 动态限流器实现

@ComponentpublicclassDynamicRateLimiterimplementsRateLimiter{@AutowiredprivateRateLimitConfigServiceconfigService;@OverridepublicMono<Response>isAllowed(StringrouteId,Stringkey){// 从数据库或配置中心获取限流规则RateLimitRulerule=configService.getRule(key);if(rule==null){returnMono.just(newResponse(true,-1));}// 使用 Redis 或其他存储实现令牌桶算法returncheckRedisRateLimit(key,rule);}privateMono<Response>checkRedisRateLimit(Stringkey,RateLimitRulerule){// 实现基于 Redis 的令牌桶算法// ...}}

4. 基于 Sentinel 的更强大方案

4.1 集成 Sentinel

<dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-sentinel</artifactId></dependency><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-alibaba-sentinel-gateway</artifactId></dependency>

4.2 Sentinel 配置

spring:cloud:sentinel:transport:dashboard:localhost:8080gateway:enabled:truefilter:enabled:false# 关闭默认的过滤器

4.3 定义限流规则

@ComponentpublicclassGatewayConfiguration{@PostConstructpublicvoidinitRules(){// 针对不同API设置不同规则initFlowRules();}privatevoidinitFlowRules(){List<GatewayFlowRule>rules=newArrayList<>();// /api/users 通用限流rules.add(newGatewayFlowRule("/api/users").setCount(30).setIntervalSec(60));// 特定接口限流rules.add(newGatewayFlowRule("/api/users/test1").setCount(10).setIntervalSec(60));rules.add(newGatewayFlowRule("/api/users/test2").setCount(20).setIntervalSec(60));GatewayRuleManager.loadRules(rules);}}

5. 完整的多层限流策略示例

@ConfigurationpublicclassRateLimitConfig{@Bean@PrimarypublicKeyResolverapiPathKeyResolver(){returnexchange->{Stringpath=exchange.getRequest().getPath().value();HttpMethodmethod=exchange.getRequest().getMethod();// 组合路径和方法作为KeyStringkey=method.name()+":"+path;// 支持通配符匹配if(path.matches("/api/users/test\\d+")){returnMono.just("users_specific:"+path);}returnMono.just(key);};}@BeanpublicRedisRateLimiterusersRateLimiter(){// 全局配置returnnewRedisRateLimiter(30,30);}@BeanpublicRedisRateLimitertest1RateLimiter(){// 特定接口配置returnnewRedisRateLimiter(10,10);}}

6. 结合 Kong 的分层限流架构

如果已经在使用 Kong,建议采用分层架构:

客户端 → Kong(IP级/粗粒度限流) → Spring Cloud Gateway(API级/细粒度限流) → 微服务

优势:

  1. Kong:处理全局流量控制、IP黑白名单、基础认证
  2. Spring Cloud Gateway:处理业务级限流、熔断降级、动态路由
  3. 解耦:限流规则可以在不同层级独立管理

总结

Spring Cloud Gateway 完全能够实现你描述的需求,而且有多种方案可选:

  • 简单场景:使用内置 RequestRateLimiter + 自定义 KeyResolver
  • 复杂场景:集成 Sentinel 获得更强大的流量控制能力
  • 企业级:结合配置中心实现动态规则管理

建议根据实际业务复杂度选择合适的方案。如果已经使用 Kong,可以让两个网关各司其职,实现多级防护。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/18 3:43:28

基于散热模组锁附应力与热应力的耦合分析

&#x1f393;作者简介&#xff1a;科技自媒体优质创作者 &#x1f310;个人主页&#xff1a;莱歌数字-CSDN博客 &#x1f48c;公众号&#xff1a;莱歌数字&#xff08;B站同名&#xff09; &#x1f4f1;个人微信&#xff1a;yanshanYH 211、985硕士&#xff0c;从业16年 从…

作者头像 李华
网站建设 2026/4/18 5:26:35

今天来讲讲AI Agent的基本原理,及一些不可不知的特性!

本文是我以自己的理解&#xff0c;结合前沿论文&#xff0c;加以李宏毅教授的AI Agent课程&#xff0c;所写下的AI agent的基本原理及特性文章&#xff0c;供大家学习参考讨论&#xff01; &#xff08;Agent是近两年极其热门且关键的话题&#xff0c;眨眼间已2026年了&#x…

作者头像 李华
网站建设 2026/4/18 5:26:14

Python使用Playwright入门教程:从环境搭建到实战应用

在Web自动化测试与爬虫开发领域&#xff0c;Playwright凭借其跨浏览器兼容性、智能等待机制和强大的网络控制能力&#xff0c;已成为开发者首选的现代化工具。本文将系统讲解Python环境下Playwright的安装配置、核心功能及实战案例&#xff0c;帮助读者快速掌握这一高效工具。 …

作者头像 李华
网站建设 2026/4/18 5:34:54

mdpi等期刊的单剑号双剑号顺序问题

在 MDPI 模板中&#xff0c;\firstnote{Current address: Affiliation.} 的含义和用法如下&#xff1a; 核心含义 firstnote 指的是作者的现地址&#xff08;Current Address&#xff09;。这在学术界非常常见&#xff0c;主要用于以下场景&#xff1a; 入职/跳槽&#xff1a…

作者头像 李华
网站建设 2026/4/17 13:26:45

AI设计:用技术提升创意效率的实战指南

AI设计的本质&#xff0c;是通过机器学习与计算机视觉技术&#xff0c;将设计中的重复性劳动技能门槛环节转化为自动化流程&#xff0c;从而让创意从业者从工具操作中解放&#xff0c;聚焦于更具价值的策略性创意——这不是替代人类&#xff0c;而是放大人类创意的价值。 从技术…

作者头像 李华
网站建设 2026/4/18 5:42:05

JS逆向学习 加密站点的渗透测试!

加密站点的渗透测试 在银行、保险、证券、能源、通信等行业的IT系统中&#xff0c;使用数据加密传输、API接口保护、关键参数签名防篡改等保护手段都是比较常见。开发人员应用这些手段和技术&#xff0c;能大大增加攻击者的攻击成本。但这些手段却不能百之百防止“黑客”入侵&…

作者头像 李华