在java自定义异常中包装第三方异常，核心做法是调用自定义异常的构造函数，将第三方异常实例作为`cause`参数传入。这样既保留了原始堆栈信息，又向上层屏蔽了具体的第三方实现细节。通常建议定义一个继承自`runtimeexception`或`checked exception`的通用业务异常类，并在捕获第三方异常时进行转换。
如何定义支持链式调用的自定义异常基类
定义自定义异常基类时，必须提供接受`Throwable`参数的构造函数，以便传递原始异常。这是实现异常包装的基础，确保调用`getCause()`能获取到被包装的第三方异常对象。基类应覆盖必要的构造方法，保持与标准异常一致的行为。
public class BusinessException extends RuntimeException {
public BusinessException(String message) {
super(message);
}
public BusinessException(String message, Throwable cause) {
super(message, cause);
}
public BusinessException(Throwable cause) {
super(cause);
}
}
如何在Service层统一捕获并转换第三方异常
在Service层调用第三方库时，使用try-catch块捕获特定的第三方异常（如`IOException`或SDK特有的异常），然后抛出之前定义的`BusinessException`。这种做法将底层技术细节转化为业务语义，例如将“网络连接超时”转换为“服务不可用”。转换时需保留原始异常作为cause，便于后续日志追踪和故障排查。
立即学习“Java免费学习笔记（深入）”；
public class OrderService {
private final PaymentClient paymentClient;
public OrderService(PaymentClient paymentClient) {
this.paymentClient = paymentClient;
}
public void payOrder(String orderId, double amount) {
try {
// 假设支付客户端可能抛出 ThirdPartyPaymentException
paymentClient.process(orderId, amount);
} catch (ThirdPartyPaymentException e) {
// 包装为业务异常，保留原始异常链
throw new BusinessException("支付处理失败: " + orderId, e);
}
}
}
当第三方异常包含敏感数据时如何处理
如果第三方异常的消息中包含敏感信息（如银行卡号、密码等），直接包装可能会泄露隐私。此时应在catch块中清理或替换敏感字段，或者仅记录内部日志而不将详细消息传递给上层。可以通过重写`getMessage()`或使用自定义的错误码来替代原始错误描述，确保对外暴露的信息安全且符合业务规范。
