31、SpringCloudAlibaba实战:熔断限流:完善sentinel-provider

补齐 sentinel-provider 的 Controller 与测试,实际核对正常、无效参数和本地限流阻断响应。

简明结论

一个完整路由应明确参数与阻断响应;本地 MVC/Sentinel 核心测试不等于整个 SCA 集成已验证。

原片段在 @GetMapping 中截断,缺少完整方法、参数条件和限流结果。下面给出能够编译的 Controller,并用独立 MVC 测试确认正常请求、无效数量与 Sentinel 阻断的返回值。

完整 Controller

新增示例使用 Spring Framework 6.1.5(由 Boot 3.2.4 管理)、Sentinel 1.8.6 与 JDK 21。它通过 SphU 显式定义资源,不依赖控制台或 SCA starter 自动注入;并未验证整个历史 sentinel-provider 工程。

package site;

import com.alibaba.csp.sentinel.Entry;
import com.alibaba.csp.sentinel.SphU;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

@RestController
public class GoodsController {
  @GetMapping("/goods/buy/{name}/{count}")
  public ResponseEntity<String> buy(@PathVariable String name,@PathVariable int count) {
    if (count<1) return ResponseEntity.badRequest().body("count-must-be-positive");
    try (Entry ignored=SphU.entry("phase6-goods")) {
      return ResponseEntity.ok("bought:"+name+":"+count);
    } catch (BlockException blocked) { return ResponseEntity.status(429).body("limited"); }
  }
}

实际请求与规则检查

复用共享 POM,将下面文件放在 src/test/java/site。MockMvc 在进程内调用 MVC,不开放 HTTP 端口。count 小于 1 返回 400;本地 QPS 规则为 0 时,合法请求返回 429,避免把阻断当作正常购买成功。

package site;

import java.util.List;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import org.junit.jupiter.api.Test;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;

class GoodsControllerTest {
  @Test void hasACompleteRouteAndExplicitBlockedResponse() throws Exception {
    var mvc=MockMvcBuilders.standaloneSetup(new GoodsController()).build();
    try {
      FlowRuleManager.loadRules(List.of());
      mvc.perform(get("/goods/buy/tea/2")).andExpect(status().isOk()).andExpect(content().string("bought:tea:2"));
      mvc.perform(get("/goods/buy/tea/0")).andExpect(status().isBadRequest());
      var rule=new FlowRule("phase6-goods");rule.setGrade(RuleConstant.FLOW_GRADE_QPS);rule.setCount(0);
      FlowRuleManager.loadRules(List.of(rule));
      mvc.perform(get("/goods/buy/tea/2")).andExpect(status().isTooManyRequests()).andExpect(content().string("limited"));
      System.out.println("route=200; invalid-count=400; blocked=429; auto-configuration-tested=false");
    } finally { FlowRuleManager.loadRules(List.of()); }
  }
}
mvn -Dtest=GoodsControllerTest test

实际输出包含 route=200; invalid-count=400; blocked=429; auto-configuration-tested=false。清空与设置规则仅在本轮隔离测试 JVM 中进行,finally 恢复空规则。

示例中的 bought 字符串不是库存扣减、支付或幂等实现。它验证路由和本地规则接入,不涵盖 Sentinel 控制台、注册中心、动态规则持久化、Spring Cloud Alibaba 自动装配或生产熔断策略。需要接入真实业务时,应先固定相容的依赖矩阵,再验证相应边界。

下一步阅读

历史截图

以下截图来自原资料,保留作参考,不能代替版本条件和可运行源码,也不是本轮测试输出。

历史资料截图 1(非本轮运行结果)