在 java 中包装 http 客户端异常，核心做法是捕获底层库抛出的运行时异常（如 ioexception），将其作为 cause 传入自定义异常的构造函数，并保留原始堆栈信息。这样既能让调用者通过 getcause() 排查网络细节，又能通过自定义类型统一处理业务逻辑。具体实现时，定义一个继承自 exception 或 runtimeexception 的类，确保其构造函数接受 string 消息和 throwable 原因。
如何定义支持 Cause 的自定义异常类
直接回答：定义一个继承自 RuntimeException 的子类，提供带 message 和 cause 参数的构造函数，并在其中调用 super(message, cause)。
public class HttpClientException extends RuntimeException {
public HttpClientException(String message, Throwable cause) {
super(message, cause);
}
public HttpClientException(String message) {
super(message);
}
}
上述代码定义了 HttpClientException。它继承了 RuntimeException，这意味着它是非检查型异常，调用者不需要强制捕获，但可以选择捕获以进行特定处理。第一个构造函数允许传入具体的错误描述和原始的 Throwable 对象。第二个构造函数用于没有底层异常时的简单报错。在实际使用中，当我们需要抛出这个异常时，只需实例化它并将底层的 IOException 传进去即可。
立即学习“Java免费学习笔记（深入）”；
如何在 HttpClient 调用中捕获并包装异常
直接回答：使用 try-catch 块包裹 HttpClient.send() 调用，捕获 IOException，然后抛出新的 HttpClientException 实例。
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ServiceClient {
private final HttpClient client = HttpClient.newHttpClient();
public String fetchData(String url) throws HttpClientException {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
return response.body();
} catch (IOException e) {
throw new HttpClientException("Failed to fetch data from " + url, e);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
throw new HttpClientException("Request interrupted", e);
}
}
}
在 ServiceClient 类中，fetchData 方法演示了完整的包装过程。client.send() 可能抛出 IOException（包括网络连接失败、超时等）或 InterruptedException。我们在 catch 块中捕获这些异常，并构造一个新的 HttpClientException。注意，我们将原始的 e 作为第二个参数传入构造函数，这保留了完整的堆栈跟踪。如果只记录日志而不重新抛出，也可以在这里处理，但通常为了保持调用链清晰，我们会向上抛出包装后的异常。对于 InterruptedException，我们恢复了线程中断状态，这是 Java 并发编程的最佳实践，防止中断信号丢失。
如何处理包装后异常中的原始堆栈信息
直接回答：通过调用 getCause() 获取原始异常，或使用 printStackTrace() 查看包含完整链路的堆栈跟踪。
public class ExceptionHandler {
public void handle(HttpClientException ex) {
Throwable cause = ex.getCause();
if (cause instanceof IOException) {
System.out.println("Network error: " + cause.getMessage());
}
ex.printStackTrace(); // 输出包含 HttpClientException 和 IOException 的完整堆栈
}
}
当异常被抛出并被上层捕获时，我们可以通过 getCause() 方法访问到底层的 IOException。这在日志记录或错误分类时非常有用。例如，我们可以判断是否是网络超时还是连接拒绝，从而采取不同的重试策略。同时，printStackTrace() 会打印出从 HttpClientException 到 IOException 的完整调用链，帮助开发者快速定位问题根源。这种设计确保了信息的完整性，既提供了高层的业务语义，又保留了底层的技术细节。
