1. 初识SentinelResource注解第一次接触Sentinel时我就被这个神奇的注解吸引了。记得当时项目刚上线就遇到了流量暴增的问题系统直接被压垮。后来引入Sentinel后用SentinelResource注解轻松解决了流量控制问题。这个注解就像是给方法套上了一层防护罩既能防流量过载又能处理异常情况。SentinelResource最核心的作用就是定义资源。在Sentinel的世界里任何需要保护的东西都叫资源比如一个API接口、一个方法调用。通过这个注解我们可以给方法打上标记告诉Sentinel这个方法很重要需要你的保护举个例子我们有个查询用户信息的接口GetMapping(/user/{id}) SentinelResource(value getUserById) public User getUserById(PathVariable Long id) { return userService.findById(id); }这里的value属性就是资源名称相当于给这个方法起了个在Sentinel中的别名。为什么要用别名因为直接使用方法名或URL作为资源名可能会有变化而value可以保持稳定。2. 详解注解核心属性2.1 blockHandler流量控制的最后防线blockHandler是我用得最多的属性。它相当于给方法设置了一个流量超标处理员。当请求量超过阈值时Sentinel就会调用这个处理员来应对而不是直接抛出难看的错误页面。我遇到过这样一个场景电商促销时商品详情接口QPS突然飙升。当时配置是这样的GetMapping(/product/{id}) SentinelResource(value getProductDetail, blockHandler handleProductBlock) public Product getProductDetail(PathVariable Long id) { return productService.getDetail(id); } public Product handleProductBlock(Long id, BlockException ex) { log.warn(商品{}请求被限流, id); return Product.emptyProduct(); // 返回一个空商品对象 }这里有几个关键点需要注意blockHandler方法必须public参数列表要和原方法一致最后加一个BlockException参数返回值类型要和原方法一致2.2 fallback异常处理的优雅方案fallback就像是方法的备胎当方法抛出异常时就会转向fallback方法。这个特别适合处理那些不太重要的服务比如获取天气信息的接口GetMapping(/weather) SentinelResource(value getWeather, fallback weatherFallback) public Weather getWeather(String city) { return weatherService.query(city); } public Weather weatherFallback(String city, Throwable t) { log.error(获取天气异常, t); return Weather.defaultWeather(); // 返回默认天气数据 }fallback和blockHandler的区别在于blockHandler处理的是Sentinel的BlockException流量控制异常fallback处理的是业务方法抛出的其他异常2.3 defaultFallback全局异常处理当项目中有很多方法需要相似的fallback逻辑时defaultFallback就派上用场了。它相当于一个万能备胎可以处理多个方法的异常RestController public class UserController { GetMapping(/user/{id}) SentinelResource(value getUser, defaultFallback defaultHandler) public User getUser(PathVariable Long id) { return userService.findById(id); } GetMapping(/user/list) SentinelResource(value listUsers, defaultFallback defaultHandler) public ListUser listUsers() { return userService.findAll(); } public User defaultHandler(Throwable t) { log.error(服务异常, t); return User.anonymousUser(); } }注意defaultFallback的方法签名比较特殊可以没有参数或者只有一个Throwable参数返回值类型要兼容所有使用它的方法3. 高级配置技巧3.1 使用外部类处理逻辑随着项目规模扩大把所有的blockHandler和fallback方法都写在Controller里会让代码变得臃肿。这时可以使用blockHandlerClass和fallbackClass属性把处理逻辑抽到外部类中。我通常会创建一个专门的handler包来存放这些类public class GlobalBlockHandlers { public static String handleProductBlock(Long id, BlockException ex) { return 系统繁忙请稍后再试; } public static String handleOrderBlock(String orderNo, BlockException ex) { return 订单服务暂时不可用; } } RestController public class ProductController { GetMapping(/product/{id}) SentinelResource(value getProduct, blockHandlerClass GlobalBlockHandlers.class, blockHandler handleProductBlock) public String getProduct(PathVariable Long id) { // 业务逻辑 } }外部类的方法必须是static的这点要特别注意。我在实际项目中就遇到过因为忘记加static导致的奇怪问题排查了好久才发现。3.2 异常过滤exceptionsToIgnore有些异常我们不想走fallback逻辑比如参数校验异常这时就可以用exceptionsToIgnoreGetMapping(/order/{id}) SentinelResource(value getOrder, fallback orderFallback, exceptionsToIgnore {IllegalArgumentException.class}) public Order getOrder(PathVariable String id) { if (!id.matches(\\d)) { throw new IllegalArgumentException(订单ID格式错误); } return orderService.getById(id); }这样当参数不合法时会直接抛出IllegalArgumentException而不会进入fallback流程。这个配置在处理输入校验时特别有用。4. 实战中的经验分享4.1 资源命名的最佳实践关于value属性的命名我总结了几条经验使用业务语义明确的名称比如queryUserByPhone比getUser更好遵循统一的命名规范比如全部小写下划线分隔避免使用可能变化的名称比如不要包含版本号对于REST接口可以结合HTTP方法和路径如GET:/api/users一个好的命名示例GetMapping(/products/{id}/stock) SentinelResource(value get_product_stock) public int getStock(PathVariable Long id) { // 查询库存逻辑 }4.2 处理方法的优化建议在处理方法的实现上我有几个建议记录详细的日志包括参数和异常信息返回有意义的错误信息方便前端处理考虑性能影响避免在处理方法中做耗时操作对于不同的异常类型可以提供不同的处理逻辑一个较完善的处理方法示例public String handleProductBlock(Long id, BlockException ex) { String rule ex.getRule().getResource(); log.warn(产品{}接口被限流规则{}, id, rule); if (ex instanceof FlowException) { return 当前访问人数过多请稍后再试; } else if (ex instanceof DegradeException) { return 服务暂时不可用请稍后重试; } return 系统繁忙; }4.3 与Spring Cloud的集成技巧在Spring Cloud项目中SentinelResource可以和Feign、RestTemplate等组件配合使用。比如在Feign客户端上的应用FeignClient(name user-service) public interface UserService { GetMapping(/users/{id}) SentinelResource(fallback getUserFallback) User getUser(PathVariable Long id); default User getUserFallback(Long id, Throwable t) { return User.anonymousUser(); } }这种用法可以给远程调用加上熔断保护避免雪崩效应。我在一个分布式项目中就用这种方式成功防止了级联故障。5. 常见问题排查5.1 注解不生效的排查步骤经常有同事问我为什么SentinelResource没效果我一般会让他们按以下步骤检查确认Sentinel依赖和Spring Cloud版本兼容检查是否开启了EnableSentinel注解确认方法是被Spring管理的Bean调用的检查AOP代理是否生效CGLIB vs JDK动态代理查看Sentinel控制台是否有对应的资源显示最常见的问题是内部方法调用导致AOP失效比如public class OrderService { public void createOrder(Order order) { // 这个方法调用不会触发Sentinel validateOrder(order); } SentinelResource(value validateOrder) public void validateOrder(Order order) { // 校验逻辑 } }5.2 性能优化建议在高并发场景下Sentinel的资源统计会带来一定的性能开销。根据我的实测经验以下几点可以优化性能合理设置统计间隔statIntervalInMs对于不重要资源可以关闭统计使用异步处理减少对主流程的影响适当调整采样率sampleCount一个性能优化的配置示例SentinelResource(value highQpsResource, blockHandler blockHandler, fallback fallback, stats false) // 关闭统计 public String highQpsMethod() { // 高频调用的方法 }6. 实际项目中的应用案例6.1 电商系统中的应用在一个电商项目中我们是这样使用SentinelResource的商品详情接口GetMapping(/products/{id}) SentinelResource(value product_detail, blockHandlerClass ProductHandlers.class, blockHandler detailBlockHandler, fallback detailFallback) public ProductDetail getDetail(PathVariable Long id) { // 复杂的查询逻辑 }秒杀接口PostMapping(/seckill/{id}) SentinelResource(value seckill_submit, blockHandler seckillBlockHandler) public Result submitSeckill(PathVariable Long id) { // 秒杀业务逻辑 } public Result seckillBlockHandler(Long id, BlockException ex) { return Result.fail(秒杀活动太火爆请稍后再试); }6.2 微服务间的调用保护在微服务架构中我们使用SentinelResource保护服务提供方RestController RequestMapping(/account) public class AccountController { GetMapping(/{userId}) SentinelResource(value get_account_info, blockHandlerClass GlobalHandlers.class, blockHandler accountBlockHandler) public Account getAccount(PathVariable String userId) { // 账户查询逻辑 } PostMapping(/freeze) SentinelResource(value freeze_account, fallback freezeFallback) public Result freezeAccount(RequestBody FreezeRequest request) { // 冻结账户逻辑 } }同时在服务消费方也进行保护Service public class OrderService { SentinelResource(value create_order, blockHandler orderBlockHandler) public Order createOrder(OrderRequest request) { // 调用账户服务 accountClient.freeze(request.getUserId(), request.getAmount()); // 创建订单逻辑 } }这种双重保护机制可以有效防止雪崩效应确保系统稳定性。