使用Lombok @Builder构建异常时如何移除栈轨迹中的build方法记录

1. 移除栈轨迹中builder方法的方式 #

你可以通过自定义build方法，手动过滤掉builder相关的栈帧，示例代码如下：

@Builder
public class MyException extends Exception {
    // 自定义build方法覆盖Lombok自动生成的逻辑
    public static class MyExceptionBuilder {
        public MyException build() {
            MyException e = new MyException(this);
            // 过滤栈轨迹，移除builder相关的栈帧
            StackTraceElement[] originalStack = e.getStackTrace();
            StackTraceElement[] filteredStack = Arrays.stream(originalStack)
                    .filter(stackElem -> !stackElem.getClassName().contains("MyExceptionBuilder"))
                    .toArray(StackTraceElement[]::new);
            e.setStackTrace(filteredStack);
            return e;
        }
    }

    // Lombok会自动生成对应参数的构造方法，也可手动实现业务逻辑
    private MyException(MyExceptionBuilder builder) {
        // 自定义构造逻辑，比如赋值错误码、业务上下文、提示信息等
    }
}

还有更轻量的实现方式：你可以在异常类的构造方法中指定 writableStackTrace 参数为false，再根据需求手动填充需要的栈轨迹即可，不过这种方案灵活度相对更低。

2. 这是否属于代码坏味道 #

不属于公认的代码坏味道。用Builder/工厂方法封装异常创建逻辑是非常普遍的工程实践，尤其当异常需要携带错误码、业务上下文、多语言提示等多个自定义参数时，Builder能避免写大量重载构造方法，大幅提升代码可读性。栈轨迹多一层Builder方法只是默认实现的小瑕疵，不属于设计层面的问题。

3. 更合理的异常Builder使用建议 #

• 如果你的异常参数不超过3个，优先用静态工厂方法代替Builder，既满足封装创建逻辑的需求，也不会产生额外的栈帧：

  public class MyException extends Exception {
      public static MyException of(String errorCode, String message) {
          return new MyException(errorCode, message);
      }
      // 私有构造方法
  }
  // 业务代码直接调用，栈轨迹不会有额外中间层
  throw MyException.of("USER_NOT_FOUND", "用户不存在");
  

• 确需使用Builder时，不要在build方法中添加额外业务逻辑，仅做对象创建和栈过滤即可，避免后续维护新增逻辑后，栈过滤反而掩盖了真实的报错位置。
• 不要在Builder内部做异常抛出操作，抛出动作永远放在业务代码侧，避免栈轨迹的判断逻辑混乱。

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