微服务下全局异常处理方案

1、新建jhjcn-common-base基础工程 2、自定义全局异常类BaseException package com.jhjcn.common.base.exception; /** * @Deacription TODO * @Author jianhua.hong * @Date 2020/2/25 9:56 **/ public class BaseException extends RuntimeException { private String code; private String message; public BaseExceptio 在微服务架构中，由于服务间的解耦和分布式特性，异常处理显得尤为重要。全局异常处理方案旨在确保系统在出现异常时能提供一致的反馈，同时避免异常传播导致服务崩溃。以下是一个具体的微服务下全局异常处理方案： 1. **新建基础工程**： 新建名为`jhjcn-common-base`的基础工程是为了集中处理通用的功能和组件，包括异常处理。这个基础工程可以被其他微服务引用，提供统一的异常处理机制。 2. **自定义全局异常类**： 创建名为`BaseException`的自定义异常类，继承自`RuntimeException`。`BaseException`包含两个字段：`code`（错误码）和`message`（错误信息）。这样设计便于在异常发生时，通过错误码和错误信息向调用方清晰地传达错误情况。提供了多个构造函数方便在抛出异常时传入不同的参数。 ```java public class BaseException extends RuntimeException { private String code; private String message; // 构造函数... } ``` 3. **异常工具类**： `ExceptionUtils`工具类用于获取异常的堆栈跟踪字符串，这在日志记录和调试过程中非常有用。它将异常的堆栈信息转换为易于阅读的字符串格式。 ```java public class ExceptionUtils { public static String getStackTraceString(Throwable ex) {...}} ``` 4. **自定义异常处理抽象类**： 定义一个抽象类`BaseExceptionHandler`，使用了`@Slf4j`注解进行日志记录，并且包含了`@ExceptionHandler`注解，表明这个类将处理`BaseException`类型的异常。`handlerCommonException`方法负责处理捕获到的`BaseException`，返回一个包含错误信息的Map结构。这个抽象类为每个微服务的具体异常处理器提供了一个模板。 ```java @Slf4j public abstract class BaseExceptionHandler { @ResponseBody @ExceptionHandler(value = BaseException.class) public Map handlerCommonException(BaseException exception) {...} } ``` 5. **构建响应映射**： `buildRespMap`方法创建一个包含错误码、错误信息以及数据的响应Map。这有助于返回给客户端一个标准的错误响应格式。 ```java protected Map<String, Object> buildRespMap(String code, String message, boolean isSuccess, Object data) {...} ``` 在实际应用中，每个微服务都会根据自身业务需求实现`BaseExceptionHandler`，并覆盖`handlerCommonException`方法，以便处理特定的业务异常。这样，当任何服务中抛出异常时，都会被全局异常处理器捕获，转化为统一的响应格式，保证了系统的稳定性和用户体验。 此外，还可以结合Spring Cloud的`@ControllerAdvice`注解来实现全局异常处理，它会在所有控制器中生效，对所有未被捕获的异常进行处理。通过这种方式，可以确保微服务中的所有异常都能得到妥善处理，避免因异常导致的服务中断。同时，良好的异常处理机制也有助于提高系统的可维护性和可调试性。