为何Java捕获的Exception堆栈跟踪未完整输出？

代码场景 #

我编写的Java代码如下：

try{
    //83 lines of stuff
} catch(Exception e){
    logger.writeLogError("*********FAILURE BEGIN*********\n");
    // 这里需要捕获顶层异常，否则异常未被捕获的话，通知不会写入数据库或发送给用户
    // 排查起来会极其困难
    e.printStackTrace();
    logger.writeLogError("*********FAILURE END*********\n");
}

但有时日志输出仅显示：

ERROR [com.place.obfuscation.Class] (WorkerThread#39[192.168.136.172:55767]) *********FAILURE BEGIN*********
ERROR [STDERR] (WorkerThread#39[192.168.136.172:55767]) java.lang.NullPointerException
ERROR [com.place.obfuscation.Class] (WorkerThread#39[192.168.136.172:55767]) *********FAILURE END*********

正常情况下应该输出完整的堆栈跟踪，为什么会出现这种情况？

原因分析 #

• 多线程流竞争：e.printStackTrace()默认输出到System.err，而自定义logger是独立的日志组件，两者的输出流没有同步机制。在多线程环境（比如示例中的WorkerThread）下，其他线程的输出可能抢占流资源，导致当前异常的堆栈被截断。
• JVM性能优化：JVM默认开启-XX:+OmitStackTraceInFastThrow参数，当同一个异常被频繁抛出时，会省略堆栈信息只保留类名，以此提升性能。
• 日志组件配置问题：如果日志框架对System.err的输出做了拦截、截断或格式限制，也可能导致堆栈信息丢失。

解决办法 #

1. 用日志框架API替代printStackTrace
   直接调用日志组件的错误日志方法，它会自动处理堆栈跟踪的输出，且和其他日志操作同步：

   logger.error("*********FAILURE BEGIN*********", e);
   logger.error("*********FAILURE END*********");
   

   这样异常的完整堆栈会被日志框架正确记录，不会出现流竞争问题。

2. 关闭JVM堆栈优化（调试阶段用）
   如果是重复异常导致的堆栈省略，可在JVM启动参数中添加-XX:-OmitStackTraceInFastThrow，强制输出完整堆栈。注意这会略微影响性能，不建议生产环境长期使用。

3. 统一输出流配置
   配置日志框架接管System.err和System.out的输出，让所有日志都走同一个通道，避免多线程下的流冲突。比如在Log4j等框架中配置对应的Appender来处理标准输出流。

内容的提问来源于stack exchange，提问作者mstabosz