CompletableFuture异常问题：无法获取完整异常原因与堆栈追踪

当使用CompletableFuture异步执行任务时，异常会被自动包装为CompletionException，导致原始异常（比如NullPointerException、IllegalStateException）的完整堆栈追踪被隐藏，难以定位问题根源。以下是几种可行的解决方法：

• 展开原始异常并打印完整堆栈
  在whenComplete回调中，递归获取最底层的根源异常，直接打印它的堆栈信息：

  CompletableFuture<Test> test = myAdapter.getTest();
  test.whenComplete((result, e) -> {
     if (e != null) {
        Throwable rootCause = e;
        // 递归剥离包装层，找到原始异常
        while (rootCause.getCause() != null && rootCause != rootCause.getCause()) {
            rootCause = rootCause.getCause();
        }
        // 输出完整堆栈
        rootCause.printStackTrace();
        // 若用日志框架，直接传入rootCause即可记录完整追踪
        // log.error("getTest异步执行失败", rootCause);
     }
  });
  

• 添加JVM参数保留完整堆栈
  JVM默认会对频繁抛出的同类异常做堆栈裁剪优化，添加以下参数可禁止该行为，确保所有异常都保留完整堆栈：

  -XX:-OmitStackTraceInFastThrow
  

• 自定义异步任务的异常包装逻辑
  如果myAdapter.getTest()是你自己实现的方法，可在异步任务中主动捕获异常并显式包装，确保原始堆栈不丢失：

  public CompletableFuture<Test> getTest() {
      return CompletableFuture.supplyAsync(() -> {
          try {
              // 业务逻辑代码
              return new Test();
          } catch (Throwable t) {
              // 显式包装异常，保留原始堆栈
              throw new CompletionException("执行getTest异步任务失败", t);
          }
      });
  }
  

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