Java异常堆栈获取分调试查看与生产记录：调试用e.printStackTrace()；日志记录须传Throwable参数，禁拼字符串；转字符串可用StringWriter或ExceptionUtils；定制解析需操作getStackTrace()数组并递归getCause()。
Java 中获取异常堆栈信息，核心是区分「查看」和「记录」两种场景：调试时快速看全貌，生产中可靠存日志。关键不是拼字符串，而是用对方法、传对参数。
直接打印到控制台（仅限开发调试）
调用 e.printStackTrace() 最快，会把异常类型、消息、抛出位置及完整调用链输出到 System.err。适合本地快速定位问题。
- 必须确保
e不为null，否则触发新的NullPointerException - 不适用于生产环境——它不走日志框架，无法归档、检索或告警
- 不能和 SLF4J 等日志混用，否则日志行错乱、堆栈被截断
转成字符串用于日志或上报
当需要把堆栈作为字符串处理（比如写入文件、发钉钉、存数据库），推荐以下两种方式：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 用 JDK 原生方式：
StringWriter sw = new StringWriter();<br>e.printStackTrace(new PrintWriter(sw));<br>String stackTrace = sw.toString();
这是最轻量、无依赖的方案，行为与ExceptionUtils.getStackTrace()一致 - 若已引入 Apache Commons Lang3，可直接用：
String stackTrace = ExceptionUtils.getStackTrace(e);
注意依赖需显式声明：org.apache.commons:commons-lang3:3.14.0，包名是org.apache.commons.lang3.exception.ExceptionUtils
用日志框架正确记录（生产首选）
SLF4J、Logback、Log4j2 都支持原生异常参数，自动展开堆栈并保留 cause 链：
立即学习“Java免费学习笔记（深入）”；
- ✅ 正确写法：
log.error("读取配置失败", e);
第二个参数必须是Throwable类型，框架才会解析并格式化整个堆栈 - ❌ 错误写法：
log.error("读取配置失败: " + e);或log.error("读取配置失败", e.toString());
只会输出异常类名和消息，堆栈完全丢失 - 检查日志配置中的 pattern 是否包含
%ex或%xEx，否则堆栈可能被截断
手动解析堆栈元素（需定制过滤或脱敏）
如果要只取前 N 层、隐藏内部包路径、加时间戳等，就得操作 StackTraceElement[]：
- 调用
e.getStackTrace()获取数组，每个元素含className、methodName、fileName、lineNumber -
e.toString()只返回异常类型 + 消息（如java.lang.NullPointerException: null），不含堆栈 - 遇到包装异常（如
InvocationTargetException），需递归调用e.getCause()向下挖根因，不能只看最外层
