Java异常链智能清洗通过分级识别责任层、剔除框架噪声、保留业务根因异常（如InsufficientBalanceException）和关键堆栈帧，重构为结构化摘要，提升错误定位效率。
Java中异常链（getCause()）常导致堆栈跟踪冗长、重复、干扰核心错误定位。所谓“智能清洗”，不是简单截断，而是保留语义关键层、剔除框架噪声、还原真实失败路径。核心思路是：**按异常类型/包名/消息特征分级识别责任层级，结合递归深度与上下文做有损压缩**。
识别并保留“业务根因”异常
真正需要关注的往往是链底或某一层抛出的原始业务异常（如 InsufficientBalanceException、InvalidOrderStateException），而非中间包装的 RuntimeException 或 ExecutionException。清洗时应：
- 从最内层（
getCause() == null）开始向上遍历，优先捕获第一个非RuntimeException/Exception的自定义异常； - 若全为通用异常，则保留消息含明确业务关键词（如 “timeout”、“duplicate key”、“not found”、“permission denied”）的那一层；
- 跳过已知无信息量的包装类：如
java.util.concurrent.CompletableFuture$UniApply、org.springframework.aop.framework.CglibAopProxy$DynamicAdvisedInterceptor等，它们的堆栈帧通常不反映业务逻辑。
折叠重复调用链与框架噪声
Spring、Netty、CompletableFuture 等框架常在异常传播中插入多层相同签名的调用（如 invoke() → proceed() → doInvoke()），或大量 lambda/anonymous class 帧。清洗策略包括：
- 对连续 3 帧以上属于同一类（或同包下工具类）且方法名含
lambda$、$$EnhancerBySpringCGLIB$$、doInvoke、invokeNext的，合并为一行摘要（如 “→ Spring AOP proxy chain (5 frames)”）； - 过滤掉
java.lang.Thread.run、java.util.concurrent.ForkJoinWorkerThread.run等线程启动点之后的纯调度帧； - 对
org.springframework包下非service/controller/repository子包的堆栈行（如spring-webmvc内部解析器、spring-core类型转换器），仅保留首尾各1帧，中间用 “... [22 frames]” 省略。
重构堆栈结构，生成可读摘要
清洗后不直接输出原始 printStackTrace()，而是构建结构化摘要：
立即学习“Java免费学习笔记（深入）”；
- 第一行：精简异常类型 + 根因消息（去除“nested exception is”等冗余前缀）；
- 第二部分：“Caused by:” 后只展示真正有区分度的上层封装（最多2层），每层标注来源模块（如 “[DAO Layer]”、“[API Gateway]”）；
- 第三部分：关键堆栈帧列表（≤8 行），优先包含：你的代码包路径下的方法、SQL/HTTP 调用点（如
JdbcTemplate.query、RestTemplate.exchange）、明显错误操作（如Objects.requireNonNull抛出点）； - 附带元数据：总 cause 深度、被折叠帧数、是否含 NPE/Timeout/DBConstraint 异常等标签，便于日志聚合分析。
轻量实现示例（不依赖外部库）
以下是一个可嵌入工具类的核心逻辑片段：
public static CleanedTrace clean(Throwable t) {
List<StackTraceElement> kept = new ArrayList<>();
Throwable root = t;
int depth = 0;
while (root != null && depth < 10) {
if (isBusinessRelevant(root)) {
kept.addAll(Arrays.asList(root.getStackTrace()).subList(0, Math.min(3, root.getStackTrace().length)));
break;
}
if (isFrameworkNoise(root.getClass().getName())) {
root = root.getCause();
depth++;
continue;
}
// 保留该层前3帧 + 标记
kept.add(new StackTraceElement(
"→ [" + getModuleLabel(root) + "] " + root.getClass().getSimpleName(),
root.getMessage(), null, -1));
break;
}
return new CleanedTrace(t, kept, depth);
}
关键是把“是否相关”、“是否噪声”、“模块打标”做成可配置策略（如用正则匹配包名、白名单类名、消息关键词），方便不同项目定制。
