先把一个现象抛给你很多同学写实体类时习惯性把Data Builder NoArgsConstructor AllArgsConstructor一股脑堆上去能编译就不管了。直到某天少写一个AllArgsConstructor编译器突然报constructor ... cannot be applied to given types或者只用了Builder结果 Jackson 反序列化时告诉你no Creators, like default constructor exist再或者一遇上继承父类的字段在子类的 builder 上怎么都点不出来。这些问题表面看是“Lombok 又出 bug 了”实际全是Builder、SuperBuilder和AllArgsConstructor、NoArgsConstructor在编译期生成的代码互相“接力”时出了岔子。这篇文章不打算复述文档而是把 Lombok 生成的字节码摊开把这三个注解之间到底是谁调用谁、谁依赖谁讲清楚。1. 先把 Builder 生成的代码“摊开”看1.1 一个最简单的 Builder 背后发生了什么先看最普通的写法Builder public class User { private String name; private Integer age; }很多人以为Builder只是“帮你省了手写 builder 类”但没想过它同时会插手构造器。Lombok 在编译期对这段代码做手脚之后等价于生成了这么一段代码public class User { private String name; private Integer age; // Lombok 自动补出来的包级私有全参构造器 User(String name, Integer age) { this.name name; this.age age; } public static UserBuilder builder() { return new UserBuilder(); } public static class UserBuilder { private String name; private Integer age; UserBuilder() {} public UserBuilder name(String name) { this.name name; return this; } public UserBuilder age(Integer age) { this.age age; return this; } public User build() { return new User(name, age); } } }注意两个关键字自动、包级私有。Builder在没有任何显式构造器的情况下会自动生成一个全参构造器但它的访问级别不是public而是包内可见。这就是后面很多问题的伏笔。1.2 build() 方法调用的是“全参构造器”这是理解一切的钥匙Builder生成的build()方法内部逻辑非常朴素把你通过链式调用设置好的每一个字段按声明顺序收集起来然后new一个目标对象。但是new的时候走的是哪条路答案不是反射 setter而是直接调用一个“参数列表覆盖所有实例字段”的构造器。这一点极其重要。很多人以为 builder 是“先创建对象再挨个 set”其实不是。Lombok 的默认策略是调用全参构造器把 builder 里暂存的值一次性传进去。既然如此目标类里就必须存在一个全参构造器否则build()这一行就会编译不过。而 Lombok 的默认补位逻辑是只要当前类里没有任何构造器它就自动生成一个包级私有的全参构造器。反过来只要类里出现了任意一个构造器不管是手写的、还是NoArgsConstructor生成的它都认为“构造器已经存在”不再帮你补全参构造器。这个“只判断有没有构造器不判断参数列表是否匹配”的行为就是Builder NoArgsConstructor组合直接编译失败的根源。后面第 4 章会细说。1.3 用 javap 验证“隐式构造器”是否存在有时候光看文档还是觉得虚不如直接看编译产物。写一个类Builder public class User { private String name; private Integer age; }编译后用 JDK 自带的javap查看javap -p User.class输出里能看到public class User { private java.lang.String name; private java.lang.Integer age; User(java.lang.String, java.lang.Integer); public static User$UserBuilder builder(); }User(java.lang.String, java.lang.Integer)没有public修饰说明这个全参构造器确实是包级私有并且是由 Lombok 生成的。如果你在类里额外写了一个NoArgsConstructor再跑一次javap会看到User()出现了但User(String, Integer)消失。这就是最直接的证据。2. 三件套为什么能共存AllArgsConstructor 与 NoArgsConstructor 的分工2.1 NoArgsConstructor 是序列化/ORM 框架的刚需在 Web 项目里Builder几乎不会单独用原因很简单Jackson、Gson、MyBatis、JPA 这类框架在反序列化或映射数据时最喜欢调用无参构造器创建对象再通过 setter 或字段反射填值。如果类里只有 Lombok 自动生成的全参构造器没有无参构造器Jackson 会直接报错com.fasterxml.jackson.databind.exc.InvalidDefinitionException: Cannot construct instance of com.example.User (no Creators, like default constructor, exist)这是我在实际项目里见到次数最多的运行期问题之一。很多人本地测试接口时没注意一到联调阶段前端传 JSON 过来服务端立刻 500。所以NoArgsConstructor对大部分框架来说是刚需。但问题来了只加NoArgsConstructor真的安全吗并不。下面的编译错误就会找上门。2.2 AllArgsConstructor 恰好补上 Builder 需要的全参构造器如果只在Builder旁边加NoArgsConstructorBuilder NoArgsConstructor public class User { private String name; private Integer age; }编译时经常会看到这样的报错constructor User in class User cannot be applied to given types; required: no arguments found: java.lang.String, java.lang.Integer reason: actual and formal argument lists differ in length原因正如第 1.2 节所说NoArgsConstructor生成了一个无参构造器Lombok 发现“类里已经有构造器了”就不再生成包级私有的全参构造器。可build()里的new User(name, age)又需要全参构造器两边对不上编译自然失败。解决办法就是补上AllArgsConstructorBuilder NoArgsConstructor AllArgsConstructor public class User { private String name; private Integer age; }这样三个注解各司其职NoArgsConstructor管框架反序列化AllArgsConstructor提供全参构造器给build()调用Builder负责生成链式建造器。三者不相冲突因为 Lombok 在生成构造器时会检查目标签名是否已存在既然AllArgsConstructor已经生成了全参构造器Builder就不会重复生成自然也不会出现“重复构造器”的编译错误。2.3 几种组合的实际效果对比为了更直观我把常见组合和后果整理成一张表假设普通类里有若干非静态字段组合无参构造器全参构造器编译状态典型风险仅Builder无有包级私有通过Jackson 反序列化报错BuilderNoArgsConstructor有无失败build()找不到全参构造器BuilderAllArgsConstructor无有public通过框架需要无参构造器时仍会炸BuilderNoArgsConstructorAllArgsConstructor有有public通过日常推荐组合顺便提醒一下RequiredArgsConstructor。这个注解只为final字段和NonNull字段生成构造器如果类里的字段恰好全是final它生成的构造器也就是全参构造器和Builder能配合但只要存在一个非 final 字段它的构造器参数列表就和全参构造器对不上build()一样会编译失败。所以实际编码时我没怎么见过RequiredArgsConstructor和Builder的组合大家碰到时多留个心眼。3. 继承场景Builder 为什么失灵SuperBuilder 如何接棒3.1 子类 builder 看不到父类字段的真正原因Builder有一个非常经典的缺陷不处理继承字段。比如父类和子类都标注了BuilderData Builder NoArgsConstructor AllArgsConstructor public class Animal { private String name; } Data Builder NoArgsConstructor AllArgsConstructor public class Dog extends Animal { private Integer age; }这时你想用Dog.builder().name(旺财)IDE 会直接提示找不到name(String)方法。原因是 Lombok 在生成DogBuilder时只会扫描Dog类自己声明的字段不会把父类的name纳入进来。于是父类字段在子类的 builder 上完全不可见。这还不是最坑的。就算你手动在Dog里加了一个包含name和age的全参构造器DogBuilder.build()里调用new Dog(name, age)时Dog的构造器隐式调用super()而Animal并没有无参构造器依然会编译失败。也就是说Builder在继承体系里不是“功能少”而是“模型不匹配”。3.2 SuperBuilder 的生成原理Builder 自身也“继承”SuperBuilder从 Lombok 1.18.2 开始提供就是为了解决继承问题。它的核心思路是让生成的 builder 类也形成继承关系子类的 builder 继承父类的 builder父类字段的 setter 由父类 builder 提供build()执行时父类部分和子类部分各管各的字段。使用方式是在父类和子类上都标注SuperBuilderData SuperBuilder NoArgsConstructor AllArgsConstructor public class Animal { private String name; } Data SuperBuilder NoArgsConstructor AllArgsConstructor public class Dog extends Animal { private Integer age; }然后就可以正常链式赋值Dog dog Dog.builder() .name(旺财) .age(3) .build();从实现细节看SuperBuilder会额外生成一个接收 builder 参数的构造器比如protected Dog(DogBuilder?, ? b)父类字段由父类的构造器负责设置子类字段由子类的构造器负责设置最终返回完整对象。这也是为什么SuperBuilder不要求“全参构造器必须存在”也能正常工作它走的是另一条构造链路。需要注意的是SuperBuilder和Builder不要在同一条继承链上混用。比如父类用Builder、子类用SuperBuilder会导致子类 builder 无法正确继承父类 builder经常出现方法签名冲突或找不到符号。要么全部统一Builder要么全部统一SuperBuilder。3.3 SuperBuilder 和构造器注解如何正确组队既然SuperBuilder不依赖全参构造器那还需要NoArgsConstructor和AllArgsConstructor吗我的建议是仍然加上尤其是NoArgsConstructor。SuperBuilder生成的是“接收 builder 的构造器”和无参构造器之间并不冲突但 JPA、Jackson、MyBatis 这些框架依旧需要无参构造器。没有NoArgsConstructor反序列化问题会原封不动地出现在继承实体上。至于AllArgsConstructor主要看业务是否需要手动new一个全字段对象。实体类里多写一个没有坏处还能避免以后需要时临时补。所以继承场景下的推荐组合是SuperBuilder NoArgsConstructor AllArgsConstructor这套组合在父类和子类上都加上基本是 JPA 继承实体、MyBatis-Plus 公共字段实体里的标准写法。4. 我踩过的一组报错从编译失败到运行期反序列化闪崩4.1 “constructor cannot be applied to given types”排查链路还记得我第一次被这个报错支配的时候代码长这样Builder NoArgsConstructor public class User { private String username; private String password; }编译报错指向build()那一行。当时第一反应是“Lombok 坏了”于是检查 IDEA 插件、检查依赖版本折腾了半天都没解决。后来打开 IDEA 右键选择 Refactor - Delombok - Builder把 Lombok 生成的代码显示出来才发现问题Builder的隐式全参构造器没了类里只有User()而生成出来的UserBuilder.build()还在傻乎乎地return new User(username, password)。完整排查链路可以总结为四步确认类上所有构造器相关注解不要漏看尤其是有没有隐式继承来的注解。用 IDE 的 Delombok 或源码生成预览看当前类到底生成了哪些构造器。编译产物用javap -p检查真实的构造器签名。看到缺失签名后补AllArgsConstructor或手写全参构造器。补完之后再编译报错消失整个过程不到五分钟。但如果不理解Builder只在“完全没有构造器”时才生成全参构造器就会一直在 IDE 设置和依赖版本里打转。4.2 “no Creators, like default constructor exist”序列化框架的怒吼另一个高频坑是Builder单独使用接口层接收 JSON 对象时直接 500。报错信息Cannot construct instance of com.example.User (no Creators, like default constructor, exist)这个报错比编译报错更隐蔽因为本地编译、启动都没问题只有请求打过来才炸。我当时检查代码发现实体类写的是Builder public class User { private String username; private String password; }Lombok 确实生成了全参构造器但它是包级私有的而且没有无参构造器。Jackson 默认需要无参构造器来创建对象结果自然失败。排查思路也简单看异常栈定位到哪个类无法实例化。查看这个类是否有无参构造器。没有就补NoArgsConstructor同时检查是否因为补了NoArgsConstructor导致第 4.1 节的编译问题。稳妥做法就是三件套一起上一步到位。4.3 编译期不报错但 builder 方法消失的“Lombok 失效”问题还有一类问题更让人抓狂代码里明明写了Builder但编译时找不到builder()方法甚至 setter、getter 也全没了。常见背景是升级 JDK 或 IDEA 后突然出现报错里往往能看到这句java: You arent using a compiler supported by lombok, so lombok will not work.这不是注解关系的问题而是 Lombok 版本和 JDK/IDE 编译器的兼容性问题。Lombok 底层需要针对特定版本的 javac 做适配JDK 21 出来之后老版本 Lombok 大概率失效。解决方式很直接升级 Lombok 到支持当前 JDK 的版本例如 1.18.30 及以上同时检查 IDEA 的 Lombok 插件版本以及是否开启了 Annotation Processing。多模块项目里还容易遇到另一种情况父模块有 Lombok 依赖子模块没显示声明导致子模块编译时注解处理器没跑起来。最好在每个需要用到 Lombok 的模块中都显式声明依赖而不是依赖传递。这类问题排查时先看单个模块能否编译出builder()方法再逐步排查依赖和注解处理器配置。5. 不同项目场景下的注解组合参考5.1 DTO/VO/Command 对象怎么配对于接口入参出参对象、命令对象这类“纯数据类”我通常直接用Data Builder NoArgsConstructor AllArgsConstructor public class UserCreateCommand { private String username; private String password; }这类对象往往要接收前端 JSON所以NoArgsConstructor必加要用 builder 做链式构造Builder必加缺了AllArgsConstructor又会导致编译问题所以三件套是最省心的组合。如果不需要被框架序列化也可以去掉NoArgsConstructor但实际项目中留着更保险。5.2 JPA/MyBatis 实体类怎么配实体类比 DTO 更敏感因为框架要在运行时反射创建对象还可能涉及懒加载、代理对象等问题。无参构造器基本是硬要求。我的基础模板是Data Builder NoArgsConstructor AllArgsConstructor TableName(user) public class User { TableId(type IdType.AUTO) private Long id; private String username; private String password; }如果实体之间存在继承把Builder统一换成SuperBuilder父类和子类保持一致Data SuperBuilder NoArgsConstructor AllArgsConstructor public class BaseEntity { private Long id; private LocalDateTime createTime; } Data SuperBuilder NoArgsConstructor AllArgsConstructor public class User extends BaseEntity { private String username; }用User.builder().createTime(...)可以正常设置父类字段这是Builder做不到的。5.3 一些进阶细节Builder.Default、toBuilder 和手写全参构造器最后补几个容易踩的细节。第一字段初始值不会自动成为 builder 默认值。例如Builder public class Config { private int timeout 3000; }直接Config.builder().build()timeout会是0而不是3000。想要 builder 里保留默认值必须显式标注Builder public class Config { Builder.Default private int timeout 3000; }第二Builder(toBuilder true)会生成实例方法toBuilder()让你基于已有对象创建一个 builder通常用来做对象拷贝或局部修改。SuperBuilder同样支持这个属性子类对象调用toBuilder()时父类字段也能被带过去。第三如果你不想暴露public全参构造器又想保留NoArgsConstructor和Builder可以手写一个私下全参构造器。因为 builder 内部类可以访问外部类的私有成员所以私有构造器也能被build()调用Data Builder NoArgsConstructor public class User { private String username; private String password; private User(String username, String password) { this.username username; this.password password; } }这种情况下Builder发现类里已经有构造器就不会再生成隐式全参构造器build()调用的是手写的私有构造器外部也无法直接new一个全字段对象。字段少时手写成本不高字段多时还是建议直接用AllArgsConstructor完事。我在实际项目里养成的习惯是先想清楚这个类是不是要进数据库、要不要被序列化、有没有继承关系再决定注解组合。业务代码里写注解不难难的是搞清楚 Lombok 在背后帮你补了哪些构造器、又会在什么时候“偷懒”不生成构造器。只要记住那条核心规则——Builder只在完全没有构造器时才自动生成全参构造器一旦出现其他构造器它就把构造责任交给你了——大部分和构造器相关的编译、反序列化报错都能一眼定位。