Lombok中@Builder与@NoArgsConstructor冲突引发参数列表长度不符错误

嘿，这个问题我之前帮好几个开发者排查过，本质是Lombok注解生成代码的逻辑冲突导致的，咱们来一步步解决它～

为什么会出现这个错误？ #

当你给类添加@Builder注解时，Lombok默认会帮你生成全参构造器，同时它会覆盖掉Java默认提供的无参构造器。这时候如果再加上@NoArgsConstructor，Lombok在生成代码时会出现构造器定义的冲突，最终导致编译报错「Actual and formal arguments lists differ in length」。

具体解决办法 #

方法1：组合使用@Builder + @NoArgsConstructor + @AllArgsConstructor #

这是最常用且稳妥的方案，因为@Builder的内部实现依赖全参构造器来构建对象，所以我们需要显式添加@AllArgsConstructor让Lombok生成全参构造器，同时用@NoArgsConstructor保留无参构造器，三者配合就能完美解决冲突。

示例代码：

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.NoArgsConstructor;

@Builder
@NoArgsConstructor // 保留无参构造器，满足框架（如Spring）的需求
@AllArgsConstructor // 提供@Builder所需的全参构造器
public class User {
    private String username;
    private Integer age;
    private String email;
}

方法2：限制全参构造器的访问权限（可选） #

如果不想让外部直接调用全参构造器，可以通过@AllArgsConstructor的access参数设置访问级别，比如设为PROTECTED或PRIVATE，这样既满足@Builder的内部需求，又不会暴露不必要的构造器：

import lombok.AccessLevel;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.NoArgsConstructor;

@Builder
@NoArgsConstructor
@AllArgsConstructor(access = AccessLevel.PROTECTED) // 仅允许子类或同包类访问全参构造器
public class User {
    private String username;
    private Integer age;
    private String email;
}

额外注意事项 #

• 避免手动编写构造器和Lombok注解生成的构造器重复，否则会再次引发冲突；
• 如果你使用的是Spring、JPA等框架，通常要求类必须有无参构造器，所以@NoArgsConstructor是必不可少的；
• 确保你的Lombok版本是较新的，旧版本可能存在一些注解组合的兼容性问题。

内容的提问来源于stack exchange，提问作者Μenelaοs