java中封装第三方异常为自定义异常的核心是用原始异常作cause构造并抛出；需继承runtimeexception或exception，提供带throwable cause的构造器，捕获时传入原始异常以保留堆栈和上下文。

在 Java 中，把第三方异常转封装为自定义异常，核心做法是：在 catch 块中捕获原始异常，然后用它作为 cause 构造你的自定义异常，并抛出。这样既保持了原有异常的上下文（堆栈、消息、嵌套原因），又统一了业务异常体系。

定义自定义异常类

继承 RuntimeException（运行时异常，无需显式 try-catch）或 Exception（检查型异常，调用处需处理）。推荐继承 RuntimeException，更符合多数业务场景的异常使用习惯。

务必提供带 Throwable cause 参数的构造方法，并调用父类对应构造器：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

public class ServiceException extends RuntimeException {
    public ServiceException(String message) {
        super(message);
    }
    public ServiceException(String message, Throwable cause) {
        super(message, cause); // 关键：把原始异常设为 cause
    }
}

在业务代码中捕获并封装

遇到第三方 SDK、HTTP 客户端（如 OkHttp、Feign）、数据库驱动等抛出的异常时，在 catch 中新建自定义异常，传入原始异常作为 cause：

• 保留原始异常信息（堆栈可追溯到根源）
• 用业务语义重命名异常类型（如 ServiceException、DataAccessException）
• 可补充上下文信息（如操作资源名、请求 ID）

try {
    String result = httpClient.execute(request); // 可能抛出 IOException
} catch (IOException e) {
    throw new ServiceException("远程服务调用失败", e);
}

进阶建议：统一异常拦截与日志记录

封装后，可在全局异常处理器（如 Spring 的 @ControllerAdvice）中统一处理你的自定义异常：

• 对不同自定义异常返回特定 HTTP 状态码和错误结构
• 记录日志时通过 e.getCause() 或 e.printStackTrace() 输出完整链路
• 避免在封装时吞掉原始异常（即不要只写 new ServiceException("xxx") 而不传 cause）

注意点

不要忽略以下细节：

• 自定义异常类必须实现序列化（加 private static final long serialVersionUID = 1L;），尤其在分布式或 RPC 场景下
• 如果第三方异常本身已含丰富信息（如 FeignException 的 status、body），可在封装时提取关键字段加入自定义消息中
• 避免层层重复封装（例如已封装过一次的自定义异常又被 catch 再包一层），导致 cause 链过长、可读性下降

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南