Java中封装第三方异常为自定义异常的核心是用原始异常作cause构造并抛出；需继承RuntimeException或Exception，提供带Throwable cause的构造器，捕获时传入原始异常以保留堆栈和上下文。
在 Java 中，把第三方异常转封装为自定义异常，核心做法是：在 catch 块中捕获原始异常，然后用它作为 cause 构造你的自定义异常，并抛出。这样既保持了原有异常的上下文（堆栈、消息、嵌套原因），又统一了业务异常体系。
定义自定义异常类
继承 RuntimeException（运行时异常，无需显式 try-catch）或 Exception（检查型异常，调用处需处理）。推荐继承 RuntimeException，更符合多数业务场景的异常使用习惯。
务必提供带 Throwable cause 参数的构造方法，并调用父类对应构造器：
public class ServiceException extends RuntimeException {
public ServiceException(String message) {
super(message);
}
public ServiceException(String message, Throwable cause) {
super(message, cause); // 关键：把原始异常设为 cause
}
}
</font>
<H3>在业务代码中捕获并封装</H3>
<p>遇到第三方 SDK、HTTP 客户端（如 OkHttp、Feign）、数据库驱动等抛出的异常时，在 catch 中新建自定义异常，传入原始异常作为 cause：</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill3430" title="Alibabacloud Sdk Client Initialization For Java"><img
src="https://img.php.cn/upload/skill/000/000/081/178955835420587.jpg" alt="Alibabacloud Sdk Client Initialization For Java" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill3430" title="Alibabacloud Sdk Client Initialization For Java">Alibabacloud Sdk Client Initialization For Java</a>
<p>在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。</p>
</div>
<a href="/xiazai/skill3430" title="Alibabacloud Sdk Client Initialization For Java" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/c1c2c2ed740f" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Java免费学习笔记（深入）</a></a>”；</p>
<ul>
<li>保留原始异常信息（堆栈可追溯到根源）</li>
<li>用业务语义重命名异常类型（如 <code>ServiceException</code>、<code>DataAccessException</code>）</li>
<li>可补充上下文信息（如操作资源名、请求 ID）</li>
</ul>
<font color="gray">
<pre class="brush:php;toolbar:false;">
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 链过长、可读性下降
