网关限流

### 配置 Sentinel 网关进行流量限制 #### 启用 Sentinel 对网关的支持 为了使 Sentinel 正确工作于 API Gateway 上，需确保引入了 `Sentinel API Gateway Adapter Common` 模块。该模块提供了必要的组件来支持网关级别的限流功能[^2]。 对于基于 Spring Cloud Alibaba 的项目，在 pom.xml 文件中加入依赖： ```xml <dependency> <groupId>com.alibaba.csp</groupId> <artifactId>sentinel-apache-httpclient-adapter</artifactId> </dependency> <!-- 如果使用的是 Spring Cloud Gateway --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-alibaba-sentinel-gateway</artifactId> </dependency> ``` #### 设置基础配置属性 在 application.yml 中添加如下配置以启用并调整基本行为: ```yaml spring: cloud: sentinel: filter: enabled: true # 开启过滤器，默认开启；如果看到URL资源，则应设为false gw-flow-rules: # 自定义网关流控规则的数据源路径（可选） source: classpath:/gateway-flow-rules.json ``` 注意当观察到 URL 资源而非预期的路由或API分组时，应当将 `filter.enabled` 设定为 `false` 来修正这一情况[^4]。 #### 创建自定义 API 分组 可以通过编码方式创建 ApiDefinition 实现更细粒度的控制。例如，假设希望把 `/api/v1/*` 下的所有请求视为同一个 API 分组来进行统一管理： ```java import com.alibaba.csp.sentinel.adapter.gateway.common.rule.ApiPredicateItem; import com.alibaba.csp.sentinel.adapter.gateway.common.rule.GatewayApiDefinitionManager; public void initCustomApis() { List<ApiPredicateItem> items = new ArrayList<>(); items.add(new SubPathMatchable().setPattern("/api/v1/**")); Set<String> apiNames = Collections.singleton("my_custom_api"); GatewayApiDefinitionManager.loadApiDefinitions(apiNames, items); } ``` 这段代码会注册一个新的名为 "my_custom_api" 的 API 分组，并将其映射至特定模式下的所有子路径上。 #### 定义网关限流规则 同样地，也可以编程化地设置 GatewayFlowRule 。这里给出一个简单的例子说明如何针对某个 Route 或者之前提到过的自定义 API 分组实施限流策略： ```java import com.alibaba.csp.sentinel.adapter.gateway.sc.callback.BlockRequestHandler; import org.springframework.context.annotation.Bean; import java.util.Collections; @Bean public BlockRequestHandler blockRequestHandler(){ return (serverWebExchange, throwable) -> serverWebExchange.getResponse() .writeWith(Mono.just( ServerHttpResponse.writeAndFlushWith(Flux.just( Mono.just(ResponseEntity.ok("{\"code\": \"429\", \"msg\":\"Too Many Requests\"}")))) )); } // 添加限流规则... List<GatewayFlowRule> rules = Arrays.asList( new GatewayFlowRule("some_route_id_or_api_group_name") .setCount(10)//每秒允许的最大访问次数 .setIntervalSec(1)); GatewayFlowRuleManager.loadRules(rules); ``` 上述片段展示了怎样设定最大 QPS （Queries Per Second）为 10 的速率限制，并指定了受影响的目标对象——这可以是一个具体的 route ID 或者前面所建立的那个叫做 “my_custom_api”的 API 分组名[^3]。