AggregateException 如何聚合多个异常
java 中通过自定义一个继承自 runtimeexception 的容器类,利用内部集合收集子异常来实现错误聚合。具体做法是定义一个包含 list 字段的类,在构造函数中接收并存储所有捕获到的异常实例,同时调用 initcause 将第一个异常设为根因。这样可以在业务逻辑中一次性抛出所有失败的操作结果,供上层统一处理。

public class AggregateException extends RuntimeException {
private final List<throwable> exceptions;
public AggregateException(List<throwable> exceptions) {
super("Multiple exceptions occurred");
this.exceptions = new ArrayList(exceptions);
if (!this.exceptions.isEmpty()) {
initCause(this.exceptions.get(0));
}
}
public List<throwable> getExceptions() {
return Collections.unmodifiableList(exceptions);
}
}</throwable></throwable></throwable>
上述代码定义了核心聚合类,它不破坏原有的异常链,而是提供 getExceptions() 方法让调用者遍历所有错误。在实际使用中,开发者只需将需要聚合的异常放入列表并实例化该类即可。
批量操作中如何收集并抛出聚合异常
在处理批量任务时,通常采用循环执行策略,逐个尝试操作并将抛出的异常存入列表,循环结束后检查列表是否为空,若不为空则抛出 AggregateException。这种做法确保了即使部分步骤失败,程序也能继续执行剩余步骤,最终汇总所有问题。

Biome 是一个基于 Rust 的高性能工具链,适用于 JavaScript、TypeScript、JSX、JSON、CSS 和 GraphQL,它将格式化和 linting 统一到一个工具中。具有 97% 的 Prettier 兼容性以及超过 450 条 lint 规则,Biome 以显著更快的执行速度取代了 ESLint 和 Prettier。
public void processBatch(List<string> items) {
List<throwable> errors = new ArrayList();
for (String item : items) {
try {
processItem(item);
} catch (Exception e) {
errors.add(e);
}
}
if (!errors.isEmpty()) {
throw new AggregateException(errors);
}
}
private void processItem(String item) {
if (item == null) {
throw new IllegalArgumentException("Item cannot be null");
}
// 模拟业务处理
}</throwable></string>
该示例展示了标准的批量处理模式。当输入列表中包含无效数据时,processItem 会抛出 IllegalArgumentException,这些异常被捕获后加入 errors 列表。循环结束后,如果存在任何错误,就会触发聚合异常的抛出,从而中断后续流程并通知调用方。
聚合异常中的异常链与根因获取
在聚合异常对象中,可以通过 getCause() 获取第一个被添加的异常作为根因,也可以通过 getExceptions() 获取完整的异常列表。这种设计允许上层代码既关注整体失败状态,又能深入分析具体的每一个错误细节。
try {
processBatch(Arrays.asList("valid", null, "also_valid"));
} catch (AggregateException ae) {
Throwable rootCause = ae.getCause();
List<throwable> allErrors = ae.getExceptions();
System.out.println("Root cause: " + rootCause.getMessage());
System.out.println("Total errors: " + allErrors.size());
}</throwable>
运行上述验证代码,控制台将输出根因信息以及错误总数。由于第二个元素为 null,因此会捕获到一个 IllegalArgumentException。如果输入更多非法项,allErrors 的大小会增加,但 rootCause 始终指向列表中的第一个异常。这种机制保证了错误信息的完整性,避免了传统异常处理中只保留最后一个错误的情况。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










