Sentinel自定义异常的三种实现方式

更新时间：2023年11月22日 10:00:35 作者：Java中文社群

Spring Cloud Alibaba Sentinel 是目前主流并开源的流量控制和系统保护组件,Spring Cloud Alibaba Sentinel 有 3 种自定义异常的实现方式,本文小编将通过代码示例给大家详细的介绍这三种实现方式,需要的朋友可以参考下

0.概述

Spring Cloud Alibaba Sentinel 有以下 3 种自定义异常的实现方式：

自定义局部异常
自定义（Sentinel）全局异常
自定义系统异常

以上这 3 种实现方式，都可以重新定义 Sentinel 的异常返回信息，它们的具体实现如下。

1.自定义局部异常

自定义局部异常是在使用 @SentinelResource 注解时，直接定义的 blockHandler 异常方法，如下代码所示：

@SentinelResource(value = "/user/getuser",
            blockHandler = "myBlockHandler")
@RequestMapping("getuser")
public String getUser(Integer uid) {
    return "User:" + uid;
}

/**
 * 定义限流/熔断等异常
 */
public String myBlockHandler(Integer uid, BlockException e) {
    String msg = "未知异常";
    if (e instanceof FlowException) {
        msg = "请求被限流了";
    } else if (e instanceof ParamFlowException) {
        msg = "请求被热点参数限流";
    } else if (e instanceof DegradeException) {
        msg = "请求被降级了";
    } else if (e instanceof AuthorityException) {
        msg = "没有权限访问";
    }
    return msg;
}

注意事项

在定义 blockHandler 方法时，需要注意以下 3 个问题：

自定义的 blockHandler 方法的返回值，必须要和原方法（使用 @SentinelResource 注解修饰的方法）的返回值保持一致。
自定义的 blockHandler 方法的参数必须和原方法参数保持一致。
自定义的 blockHandler 方法的方法参数中必须包含 BlockException 参数。

如果不满足以上事项中的任何一项，那么就不能正常匹配到自定义的 blockHandler 方法，并且程序也会报错。

2.自定义全局异常

自定义 Sentinel 全局异常需要实现 BlockExceptionHandler 类，并重写 handle 方法，如下代码所示：

import com.alibaba.csp.sentinel.adapter.spring.webmvc.callback.BlockExceptionHandler;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.block.authority.AuthorityException;
import com.alibaba.csp.sentinel.slots.block.degrade.DegradeException;
import com.alibaba.csp.sentinel.slots.block.flow.FlowException;
import com.alibaba.csp.sentinel.slots.block.flow.param.ParamFlowException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;

@Component
public class SentinelExceptionHandler implements BlockExceptionHandler {
    @Override
    public void handle(HttpServletRequest request, HttpServletResponse response, BlockException e) throws Exception {
        String msg = "未知异常";
        int status = HttpStatus.TOO_MANY_REQUESTS.value();
        if (e instanceof FlowException) {
            msg = "请求被限流了";
        } else if (e instanceof ParamFlowException) {
            msg = "请求被热点参数限流";
        } else if (e instanceof DegradeException) {
            msg = "请求被降级了";
        } else if (e instanceof AuthorityException) {
            msg = "没有权限访问";
            status = HttpStatus.UNAUTHORIZED.value();
        }
        response.setContentType("application/json;charset=utf-8");
        response.setStatus(status);
        response.getWriter().println("{\"msg\": " + msg + ", \"code\": " + status + "}");
    }
}

自定义 Sentinel 全局异常是在执行 Sentinel 控制台设置的限流和熔断异常时，执行的全局自定义异常方法。

但是，如果是程序中出现的 Sentinel 报错信息，例如使用热点限流时，因为要配合使用 @SentinelResource 注解时，此时只自定义了 value 属性，未定义局部 blockHandler 方法，此时系统就会报错，但这个时候并不会执行 Sentinel 全局自定义异常，而是程序报错，此时就需要使用系统自定义异常来重新定义异常信息了。

3.自定义系统异常

自定义系统异常需要新建一个异常类，并且使用 @RestControllerAdvice 注解修饰此类，并配合 @ExceptionHandler 注解来完成全局系统异常的获取和定义，具体实现代码如下：

import com.alibaba.csp.sentinel.slots.block.authority.AuthorityException;
import com.alibaba.csp.sentinel.slots.block.degrade.DegradeException;
import com.alibaba.csp.sentinel.slots.block.flow.FlowException;
import com.alibaba.csp.sentinel.slots.block.flow.param.ParamFlowException;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import java.util.HashMap;
import java.util.Map;


@RestControllerAdvice
public class CustomExceptionHandler {

    /**
     * 限流全局异常
     */
    @ExceptionHandler(FlowException.class)
    public Map handlerFlowException(){
        return new HashMap(){{
            put("code", HttpStatus.TOO_MANY_REQUESTS.value());
            put("msg", "被限流");
        }};
    }

    /**
     * 熔断全局异常
     */
    @ExceptionHandler(DegradeException.class)
    public Map handlerDegradeException(){
        return new HashMap(){{
            put("code", HttpStatus.TOO_MANY_REQUESTS.value());
            put("msg", "被熔断");
        }};
    }

    /**
     * 热点限流异常
     */
    @ExceptionHandler(ParamFlowException.class)
    public Map handlerparamFlowException(){
        return new HashMap(){{
            put("code", HttpStatus.TOO_MANY_REQUESTS.value());
            put("msg", "热点限流");
        }};
    }

    /**
     *  Sentinel 权限拦截全局异常
     */
    @ExceptionHandler(AuthorityException.class)
    @ResponseBody
    public Map handlerAuthorityException(){
        return new HashMap(){{
            put("code", HttpStatus.UNAUTHORIZED.value());
            put("msg", "暂无权限");
        }};
    }
}

此时，只要是系统中出现的 Sentinel 报错信息，都会被此方法所捕获，并通过自定义的代码完成自定义异常信息的返回。

小结

Sentinel 有 3 种自定义异常的实现：自定义局部异常、自定义（Sentinel）全局异常、自定义系统异常。自定义局部异常作用范围比较小，需要给每个资源单独设置才行；而自定义全局异常作用范围比较大，但如果是程序报错，也不会执行其方法，所以需要配合系统异常同时来完成自定义异常的返回。

PS：如果这 3 种自定义异常同时存在，那么它的执行优先级是：自定义局部异常 > 自定义全局异常 > 自定义系统异常。

以上就是Sentinel自定义异常的三种实现方式的详细内容，更多关于Sentinel自定义异常的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

优化Java代码中if-else的方案分享
代码可读性是衡量代码质量的重要标准，可读性也是可维护性、可扩展性的保证,而我们在编程时常常会发现代码中有大量if else语句，如何进行优化呢，下面就来和大家详细聊聊
2023-05-05
详解java一维数组及练习题实例
在本篇文章里小编给大家整理了关于java一维数组及练习题的相关知识点和实例代码，有需要的朋友们跟着学习下。
2019-07-07
Java实现单例模式的五种方式总结
这篇文章主要介绍了如何实现一个单例模式,包括构造器私有化、提供静态私有变量和公共获取实例接口,文中通过代码介绍的非常详细,需要的朋友可以参考下
2025-01-01
Java redisson实现分布式锁原理详解
这篇文章主要介绍了Java redisson实现分布式锁原理详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-02-02
java反射总结实例详解
这篇文章主要结合实例形式分析了介绍了java基于反射得到对象属性值的方法,Class类，基本数据类型，类的反射等，需要的朋友可以参考下
2017-04-04
一篇文章带你理解Java的SPI机制(图文并茂)
本文详细介绍了Java的SPI机制,包括其定义、用途和实现方式,SPI(ServiceProviderInterface)是一种服务发现机制,用于实现框架或库的扩展点,文中通过代码介绍的非常详细,需要的朋友可以参考下
2024-10-10
详解SpringMVC 自动封装枚举类的方法
springmvc默认无法自动封装枚举类，本篇文章主要介绍了详解SpringMVC 自动封装枚举类的方法，有兴趣的可以了解一下。
2017-04-04
初探Java中的泛型
这篇文章主要介绍了Java中泛型的相关资料，帮助大家更好的理解和学习Java，感兴趣的朋友可以了解下
2020-08-08
关于springboot集成阿里云短信的问题
这篇文章主要介绍了springboot集成阿里云短信的方法，本文通过实例代码图文相结合给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2021-11-11
初识MyBatis及基本配置和执行
这篇文章主要介绍了初识MyBatis的基本知识，文中给大家提到了mybatis基本配置和执行过程,需要的朋友可以参考下
2017-11-11