Java中MinIO上传失败时应通过异常链保留底层响应，即用ErrorResponseException等原始异常作为cause封装进自定义StorageUploadException，确保调用方可通过getCause()追溯HTTP状态码、错误码及响应体。
Java中利用异常链在MinIO上传失败时保留底层响应，关键是将MinIO SDK抛出的原始异常（如 ErrorResponseException、InternalException 或 IOException）作为“原因”（cause）封装进自定义业务异常，而不是丢弃或仅记录日志。这样调用方能通过 getCause() 逐层追溯到原始HTTP状态码、错误码、服务端消息和响应体。
捕获并保留MinIO原始异常
MinIO Java SDK（v8.5+）在上传失败时通常抛出带完整HTTP上下文的异常，例如：
-
ErrorResponseException：含errorCode、errorMessage、statusCode、responseBody -
InternalException：含底层IOException或连接超时细节 -
XmlParserException：解析服务端XML响应失败时抛出
应直接捕获这些异常，并以它们为 cause 构造新异常：
try {
minioClient.putObject(
PutObjectArgs.builder()
.bucket("my-bucket")
.object("photo.jpg")
.stream(inputStream, -1, PutObjectArgs.MIN_MULTIPART_SIZE)
.build()
);
} catch (ErrorResponseException e) {
throw new StorageUploadException("Failed to upload object to MinIO", e);
} catch (Exception e) {
throw new StorageUploadException("Unexpected error during MinIO upload", e);
}
定义支持异常链的业务异常类
自定义异常需显式接收 Throwable cause 并调用父类构造器，确保链路不中断：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
public class StorageUploadException extends RuntimeException {
public StorageUploadException(String message, Throwable cause) {
super(message, cause); // 关键：传递 cause
}
}
避免使用仅接受 String 的单参构造器，否则异常链断裂，原始响应信息丢失。
提取并透传关键响应信息（可选增强）
若需在日志或监控中快速定位问题，可在自定义异常中额外缓存关键字段，但不破坏原有 cause 链：
public class StorageUploadException extends RuntimeException {
private final int statusCode;
private final String errorCode;
private final String errorMessage;
public StorageUploadException(String message, ErrorResponseException cause) {
super(message, cause);
this.statusCode = cause.httpResponse().statusCode();
this.errorCode = cause.errorResponse().errorCode();
this.errorMessage = cause.errorResponse().message();
}
// 提供只读访问方法，便于上层处理
public int getStatusCode() { return statusCode; }
public String getErrorCode() { return errorCode; }
public String getErrorMessage() { return errorMessage; }
}
下游安全地解包并使用原始响应
调用方可通过递归遍历 cause 链获取原始 MinIO 异常，进而访问响应细节：
try {
storageService.upload("photo.jpg", stream);
} catch (StorageUploadException e) {
Throwable rootCause = e;
while (rootCause != null && !(rootCause instanceof ErrorResponseException)) {
rootCause = rootCause.getCause();
}
if (rootCause instanceof ErrorResponseException ex) {
System.err.println("MinIO error: " + ex.errorResponse().errorCode());
System.err.println("HTTP status: " + ex.httpResponse().statusCode());
// 可进一步读取 responseBody 字节流做结构化解析
}
}
不复杂但容易忽略
