StackWalker API 是 Java 9 引入的堆栈分析工具，支持惰性流、精准过滤（如跳过 Spring/AOP 帧）、深度控制（limit/skip）、类引用比对及日志集成优化。
StackWalker API 是 Java 9 引入的真正实用工具，它让堆栈信息不再“一锅端”，而是可筛选、可跳过、可定制。相比 Thread.getStackTrace() 或 printStackTrace() 那种全量抓取+字符串解析的老路，StackWalker 用惰性流和精准过滤，直接避开 JDK 内部类、代理层、AOP 织入点等干扰帧，只留下业务关键调用链。
跳过指定包或类的堆栈帧
微服务中常见 Spring AOP、WebMvc、Netty 等多层封装，原始错误点常被埋在十几层之下。用 filter() 可直接排除这些干扰：
- 跳过所有
org.springframework.和java.lang.reflect.开头的帧：s.filter(f -> !f.getClassName().startsWith("org.springframework.") && !f.getClassName().startsWith("java.lang.reflect.")) - 保留业务包（如
com.myapp.service）的首次出现帧，快速定位入口：s.filter(f -> f.getClassName().startsWith("com.myapp.service")).findFirst() - 配合
Option.SHOW_REFLECT_FRAMES控制是否包含反射调用——不需时直接关掉，避免日志里全是Method.invoke
限制深度与截断冗余调用
不是所有场景都需要完整堆栈。高频日志或链路追踪中，过深的帧既占空间又难读：
- 只取最上面 5 层（含当前方法）：
s.limit(5) - 跳过前 3 层（比如过滤掉日志包装器、统一异常处理器等固定前导帧）：
s.skip(3) - 组合使用更灵活：先
skip(2)去掉日志门面调用，再limit(8)保留核心业务路径
保留类引用，避免字符串匹配误差
传统方式靠 getClassName() 字符串判断，容易因类名相似误判。启用 Option.RETAIN_CLASS_REFERENCE 后，可直接比对 Class 对象：
立即学习“Java免费学习笔记（深入）”；
- 精准识别某个类的调用位置：
f.getDeclaringClass() == MyService.class - 跳过所有 JDK 自带类（
java.*、javax.*、sun.*）：!f.getDeclaringClass().getName().startsWith("java.") - 注意：该选项会增加少量内存开销，但换来的是类型安全和零歧义匹配
集成日志框架输出精简堆栈
光过滤堆栈还不够，得让它真正进日志且不被二次展开：
- Logback 中避免用
%ex（默认递归展开 cause 链），改用%ex{0}禁用 cause 展开 - 自定义
ThrowableRenderer：检查getStackTrace().length == 0时返回空字符串，防止空堆栈仍触发 fallback 渲染 - Spring 的
@ControllerAdvice捕获异常后，若已用 StackWalker 提前清理过堆栈，记得用logger.error("msg", ex)而非ex.printStackTrace()，否则前功尽弃
