StackWalker 是 Java 9 引入的轻量级堆栈快照工具，专为降低 GC 压力、避免 StackTraceElement 大量分配而设计，不替代 getStackTrace()，而是适用于高频日志、AOP、监控等场景。
StackWalker 是什么，为什么不用 Thread.currentThread().getStackTrace()
它不是替代 Thread.currentThread().getStackTrace() 的“升级版”，而是为特定场景设计的轻量级堆栈快照工具——比如只查调用方类名、跳过中间框架层、避免创建大量 StackTraceElement 对象。Java 9 引入它，核心目标是解决老方法在高频日志、AOP、监控等场景下 GC 压力大、性能抖动明显的问题。
常见错误现象：getStackTrace() 在循环里频繁调用，JVM 突然卡顿，堆内存里冒出一堆 StackTraceElement 实例；而 StackWalker 默认走惰性遍历，不触发对象分配。
- 默认使用
StackWalker.getInstance(StackWalker.Option.RETAIN_CLASS_REFERENCE)，能直接拿到Class对象，省去字符串解析和类加载开销 - 不支持获取行号（除非显式加
StackWalker.Option.SHOW_LINE_NUMBER），这是刻意设计的取舍：换来了更快的遍历速度和更低的内存占用 - 不能跨线程复用同一个
StackWalker实例——它绑定当前线程的栈帧，每次调用walk()都是实时快照
怎么用 walk() 提取调用方信息（最常用场景）
绝大多数时候，你只是想快速知道“谁调用了我”，比如做简易权限检查、打调试日志、实现类似 SLF4J 的 caller-aware logger。这时候别写循环遍历，直接用 walk() + lambda：
StackWalker walker = StackWalker.getInstance(StackWalker.Option.RETAIN_CLASS_REFERENCE);
String callerName = walker.walk(s -> s.skip(1).findFirst())
.map(frame -> frame.getClassName())
.orElse("unknown");
说明：skip(1) 是为了跳过当前方法（即 walk() 所在的那层），findFirst() 拿到上一层调用者。注意这个流是短路的，不会遍历整个栈。
立即学习“Java免费学习笔记（深入）”；
- 如果要跳过框架层（比如 Spring AOP 代理），得结合
Predicate过滤：s.filter(f -> !f.getClassName().startsWith("org.springframework")) -
walk()方法必须立刻消费返回的Stream，延迟执行（比如存起来 later map）会抛IllegalStateException - 别在
walk()的 lambda 里 throw 异常——异常会中断流，且栈帧可能已被回收，后续再 walk 可能行为异常
StackWalker.Option 的实际影响（不是全都要）
四个选项里，只有两个真正影响性能和行为：RETAIN_CLASS_REFERENCE 和 SHOW_LINE_NUMBER。其余两个（SHOW_HIDDEN_FRAMES、INCLUDE_PRIVATE_FRAMES）极少用，且开启后可能暴露 JVM 内部帧或引发 SecurityException。
-
RETAIN_CLASS_REFERENCE：让StackFrame.getDeclaringClass()返回真实Class，否则返回null；但要求调用方有RuntimePermission("getClassLoader") -
SHOW_LINE_NUMBER：开启后才能调用getLineNumber()，但会触发完整符号解析，性能下降约 3–5 倍（实测 JDK 17） - 多个 Option 用
|或传Set.of(...)，不要漏掉RETAIN_CLASS_REFERENCE就直接调getDeclaringClass()，否则 NPE
兼容性和替代方案（Java 8 怎么办）
StackWalker 是 Java 9+ 特性，无法回填。如果项目还要支持 Java 8，别封装“统一栈工具类”假装兼容——运行时会 NoClassDefFoundError。更现实的做法是分路径处理：
if (Runtime.version().feature() >= 9) {
return StackWalker.getInstance(...).walk(...);
} else {
// 用 getStackTrace() + 手动解析 className，跳过已知框架包
return parseCallerFromLegacy(Thread.currentThread().getStackTrace());
}
注意：Runtime.version().feature() 比 System.getProperty("java.version") 更可靠，后者在某些容器里可能被篡改。
容易被忽略的一点：StackWalker 在 GraalVM Native Image 中默认不可用，需显式添加反射配置并启用 --enable-preview（若用的是预览版 API）。不是所有“Java 9+”环境都真正支持它。
