欢迎光临
我们一直在努力

别再写一长串构造器了!Java 建造者模式(Builder Pattern)实战避坑指南

大家好,我是 IT空门 · 门主。 分享 AI 与代码,顺便抢救发际线。


一、为什么写这篇?

最近在改一个老项目,赫然看到一段"祖传代码":

new User("张三", 28, "zhangsan@xx.com", "13800000000",
"北京市朝阳区", true, false, 1, "VIP", "2024-01-01", ...);

我数了一下,11 个参数。

那一瞬间我血压上来了。 这要是让你维护,你敢动?你敢改?你敢加参数?

相信我,每一个看这段代码的人,脑子里都飘过同一句话:

“这是哪个天才写的?”

别笑,90% 的 Java 项目里都埋着这种雷。

而解决这个问题的"银弹",就是今天的主角——建造者模式(Builder Pattern)。


二、什么是建造者模式?

1. 一句话定义

建造者模式是一种创建型设计模式,它将一个复杂对象的构建过程与它的表示分离,使同样的构建过程可以创建出不同的表示。

说人话就是:

“你要造一辆车,不用关心发动机怎么装、轮胎怎么拧,你只需要告诉 Builder:我要 V8 发动机、19 寸轮毂、红色车漆。”

Builder 帮你按顺序拼好,你拿到就是一辆完整的车。

2. 四个核心角色

角色作用通俗理解
Product(产品) 最终要创建的复杂对象 那辆组装好的车
Builder(抽象建造者) 定义构建步骤的接口 装配手册
ConcreteBuilder(具体建造者) 实现具体的构建逻辑 流水线工人
Director(指挥者) 控制构建顺序(可选) 车间主任

💡 实际开发中,90% 的场景会省略 Director,直接用 链式调用 + build(),最经典的就是 Lombok 的 @Builder。


三、Java 中哪些地方在大量用建造者模式?

如果你以为这只是"设计模式书里的玩具",那就太天真了。 你每天写的代码,背后都是它。

1. JDK 自家兄弟

// StringBuilder
new StringBuilder()
.append("IT空门")
.append("·")
.append("门主")
.toString();

// Stream Builder
Stream<String> stream = Stream.<String>builder()
.add("Java")
.add("Spring")
.add("AI")
.build();

2. Lombok 的 @Builder(Spring Boot 项目 100% 在用)

@Builder
@Data
public class UserDTO {
private String name;
private Integer age;
private String email;
}

UserDTO user = UserDTO.builder()
.name("门主")
.age(18)
.email("xxx@xx.com")
.build();

3. 主流框架的"链式门面"

框架/工具Builder 场景
OkHttp OkHttpClient.Builder()
Retrofit Retrofit.Builder()
Spring Security HttpSecurity 配置
MyBatis-Plus QueryWrapper 条件构造器
Elasticsearch Java Client 各种 *Request.Builder()
Kafka Producer KafkaProducer 配置

看到没? Builder 模式是 Java 生态的"通用语言"。 你不学它,连框架的源码都看不懂。


四、建造者模式到底解决了什么?(为什么非用不可?)

痛点 1:构造器参数爆炸(Telescoping Constructor)

// 噩梦写法
public User(String name) {}
public User(String name, int age) {}
public User(String name, int age, String email) {}
public User(String name, int age, String email, String phone) {}
// …参数每加一个,构造函数就翻倍

调用时你根本不知道哪个参数是干嘛的:

new User("张三", 28, "13800000000", "北京", true); // 这 true 是啥?

痛点 2:Setter 满天飞,对象状态不完整

User user = new User();
user.setName("张三");
// 忘了 setAge
service.process(user); // NPE 在向你招手

痛点 3:不可变对象做不出来

如果想搞 final 字段 + 无 setter + 线程安全,构造器是你唯一的选择。 但参数一多,构造器就变成"意大利面条"。

✅ 建造者模式的解法

User user = User.builder()
.name("张三")
.age(28)
.email("xxx@xx.com")
.phone("13800000000")
.address("北京")
.vip(true)
.build();

可读性 ✅ 不可变 ✅ 线程安全 ✅ 参数可扩展 ✅


五、优缺点分析(带避坑)

✅ 优点

优点说明
可读性爆表 像读英语一样读代码
解决构造器爆炸 不用再写 N 个构造函数
天然支持不可变 配合 final 字段无敌
参数可灵活组合 必选/可选分得清清楚楚
便于校验 在 build() 里统一校验参数
线程安全 Builder 本身不是,但构建出的对象是不可变的

❌ 缺点

缺点说明
代码量多 至少多一个内部类(Lombok 解决)
小对象过度设计 2~3 个字段就别装了
Builder 复用性差 一次构建完就废了,别复用
Builder 本身非线程安全 千万别多线程共享一个 Builder
调试时栈深 链式调用多了,debug 一层层进

⚠️ 6 个最容易踩的坑(实战血泪)

坑 1:@Builder 默认值失效

// ❌ 错误:默认值是 null,不是 []
@Builder
public class PageQuery {
private List<String> tags = new ArrayList<>(); // 失效!
}

// ✅ 正确:必须加 @Builder.Default
@Builder
public class PageQuery {
@Builder.Default
private List<String> tags = new ArrayList<>();
}

坑 2:@Builder 和 @NoArgsConstructor 打架

// ❌ 错误:@Builder 找不到构造器,悄悄失效
@Builder
@NoArgsConstructor
public class User {}

// ✅ 黄金组合:三者齐上(DTO 必备)
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class User {}

坑 3:父子类继承时 @Builder 失效

// ❌ 普通 @Builder 不支持父类字段
public class Animal {
private String species;
}
public class Cat extends Animal {
private String color;
}
// Cat.builder().species("猫").color("白") // 编译失败,species 没有

// ✅ 必须用 @SuperBuilder(Lombok ≥ 1.18.12)
@SuperBuilder
public class Animal { private String species; }

@SuperBuilder
public class Cat extends Animal { private String color; }

坑 4:Jackson 反序列化炸了

// ❌ @Builder 生成的对象,Jackson 反序列化会找不到无参构造器
@Builder
public class User {}

// ✅ 加上 @Jacksonized(Lombok ≥ 1.18.14)
@Builder
@Jacksonized
public class User {}

坑 5:Builder 复用导致"幽灵字段"

Builder<User> builder = User.builder().name("张三");
User u1 = builder.age(18).build();
User u2 = builder.build(); // ⚠️ u2 也带 age=18!复用 Builder 翻车

结论:一个 Builder 就 build 一次,用完就扔。

坑 6:把 Builder 当 Setter 用,乱序赋值

// ❌ 把校验逻辑写在 setter 里,对象还能处于"半成品"状态
public Builder age(int age) {
this.age = age;
return this;
}

// ✅ 校验统一放 build(),拒绝"半成品"
public User build() {
if (age < 0 || age > 150) {
throw new IllegalArgumentException("年龄不合法");
}
if (StringUtils.isBlank(name)) {
throw new IllegalArgumentException("姓名不能为空");
}
return new User(this);
}


六、代码实战:手写一个企业级 Builder

别只盯着 Lombok,手写一次才能真正理解原理。

场景:构造一个"系统通知"对象

必选字段:接收人 通知类型 可选字段:标题 内容 跳转链接 优先级 附件列表

1. 产品类(Product)

/**
* 系统通知(不可变对象)
* @author IT空门
*/

public final class Notice {

// 必选
private final String receiver;
private final NoticeType type;

// 可选
private final String title;
private final String content;
private final String url;
private final Priority priority;
private final List<String> attachments;

// 私有构造,只能通过 Builder 创建
private Notice(Builder builder) {
this.receiver = builder.receiver;
this.type = builder.type;
this.title = builder.title;
this.content = builder.content;
this.url = builder.url;
this.priority = builder.priority;
// 防御性拷贝,防止外部修改影响内部状态
this.attachments = builder.attachments == null
? Collections.emptyList()
: Collections.unmodifiableList(new ArrayList<>(builder.attachments));
}

public static Builder builder(String receiver, NoticeType type) {
return new Builder(receiver, type);
}

// 省略 getter …
public String getReceiver() { return receiver; }
public NoticeType getType() { return type; }
// … 其他字段
}

2. 静态内部 Builder

public static final class Builder {

// 必选
private final String receiver;
private final NoticeType type;

// 可选(带默认值)
private String title = "系统通知";
private String content = "";
private String url = "";
private Priority priority = Priority.NORMAL;
private List<String> attachments;

// 必选字段强制通过构造器传入
private Builder(String receiver, NoticeType type) {
this.receiver = receiver;
this.type = type;
}

public Builder title(String title) {
this.title = title;
return this;
}

public Builder content(String content) {
this.content = content;
return this;
}

public Builder url(String url) {
this.url = url;
return this;
}

public Builder priority(Priority priority) {
this.priority = priority;
return this;
}

public Builder attachment(String attachment) {
if (this.attachments == null) {
this.attachments = new ArrayList<>();
}
this.attachments.add(attachment);
return this;
}

/**
* 终极构建:统一校验
*/

public Notice build() {
// 1. 必填校验
if (receiver == null || receiver.isEmpty()) {
throw new IllegalArgumentException("接收人不能为空");
}
if (type == null) {
throw new IllegalArgumentException("通知类型不能为空");
}
// 2. 业务校验
if (priority == Priority.URGENT && (content == null || content.length() < 5)) {
throw new IllegalArgumentException("紧急通知内容不能少于 5 个字");
}
return new Notice(this);
}
}

3. 客户端调用(丝滑体验)

// 场景 1:只填必选
Notice n1 = Notice.builder("张三", NoticeType.SYSTEM).build();

// 场景 2:链式配置
Notice n2 = Notice.builder("李四", NoticeType.MESSAGE)
.title("您的订单已发货")
.content("订单号: 20260112001, 顺丰快递")
.url("https://example.com/order/20260112001")
.priority(Priority.HIGH)
.attachment("2026-06-12sdp10ioyhlq.jpg")
.attachment("2026-06-12iyhbx0j4x2d.png")
.build();

// 场景 3:紧急通知触发校验
Notice n3 = Notice.builder("王五", NoticeType.ALERT)
.priority(Priority.URGENT)
.content("bug") // ⚠️ 触发业务校验
.build();
// 抛出:紧急通知内容不能少于 5 个字

看到没?

  • 必选参数 在 Builder 构造器里强制传,少一个都编译不过
  • 可选参数 想填哪个填哪个,不填走默认值
  • 校验 集中在 build(),杜绝"半成品对象"
  • 不可变 + 防御性拷贝 保证线程安全

七、建造者模式 vs 工厂模式(别再傻傻分不清)

这是面试高频题,一张表搞定:

对比维度建造者模式工厂模式
关注点 怎么一步步造出来 造出哪个种类
过程 分步骤、链式 一个方法搞定
适合场景 复杂对象、参数多 对象种类多
返回结果 同一个产品,不同表示 不同产品类型
典型例子 OkHttpClient.Builder Calendar.getInstance()

一句话区分:

  • 工厂模式:你要什么,我给你什么(What)
  • 建造者模式:你要怎么造,我一步步给你造(How)

八、避坑速查表(直接抄走)

场景推荐写法备注
普通 DTO/VO @Data + @Builder + @NoArgsConstructor + @AllArgsConstructor 四件套黄金组合
实体类(MyBatis-Plus) @Data + @Builder + @NoArgsConstructor 实体别加 @AllArgsConstructor
父子类继承 @SuperBuilder 父类也加
需要默认值 @Builder.Default 别忘了它
Jackson 序列化 @Builder + @Jacksonized Lombok ≥ 1.18.14
Spring 配置类 别用 @Builder 用 @ConfigurationProperties
2~3 个字段 别用 Builder 过度设计
校验逻辑 写在 build() 里 别散在 setter

九、写在最后 & 拓展阅读

建造者模式不难,难的是有人愿意告诉你坑在哪。

它不是什么高深莫测的设计模式,而是 Java 工程师每天都在用、但不一定意识到的"基建"。

记住三个关键词:

链式调用 · 不可变对象 · build() 校验

从今天开始:

  • 看到 4 个以上参数的类,别犹豫,Builder 走起;
  • 看到 2~3 个字段的类,克制,别装;
  • 看到 @Builder 旁边没配 @NoArgsConstructor,心里默默帮他补上。

技术不难,难的是没人告诉你坑在哪。 如果这篇帮到你,点个赞,顺便帮我抢救一下发际线 😄


🙏 作者介绍

📌 写文不易,Bug 更不易。

如果这篇文章对你有帮助,可以搜一搜:空门技术栈

这里分享:

  • ✅ Java / Spring AI / 企业级项目实战
  • ✅ Docker / RAG知识库 / 微服务踩坑
  • ✅ Python、前端、AI应用落地
  • ✅ 偶尔分享一些「头发保卫战」经验 😆

一个热爱技术、持续填坑的开发者, 陪你一起少踩坑,少加班,多写优雅代码。

📖 推荐阅读

Java 建造者模式详解:从入门到实战,附避坑指南

AI 为什么总"失忆"?LangChain Memory 完全指南:从 InMemory 到 Redis 实战避坑

Java 单例模式详解:7 种实现方式 + volatile 原理 + 反射与序列化问题

告别手动复制接口文档!Apifox MCP + AI 自动测试让开发效率起飞

别再纠结学哪个了!Java AI 三大框架深度对比:Spring AI vs AgentScope-Java

MySQL MCP Server 从零安装到使用实战,AI 直接查询数据库

Spring 注入三剑客:@Resource、@Autowired、@RequiredArgsConstructor 到底该用哪个?

Spring Event 用了三年,同事一句话把我问懵了


🤝 技术交流 / 项目合作

平时也会做一些技术项目与咨询,包括:

  • Java / Spring Boot 企业级项目开发
  • AI 应用开发(LangChain、RAG、Agent、知识库)
  • Docker / Linux / 私有化部署
  • 系统功能开发、接口对接、性能优化
  • 疑难问题排查与技术咨询

如果你:

  • 想做 AI 项目,但不确定技术方案
  • 项目卡在某个 Bug 很久
  • 想把 AI 接入现有系统
  • 需要企业级开发支持

欢迎交流。

📮 联系方式:

  • Email:2929119150@qq.com
  • 也可以私信我
  • 技术交流可通过个人主页联系

有些坑,一个人踩是事故;一起踩,就是经验 😎

赞(0)
未经允许不得转载:171主机测评 » 别再写一长串构造器了!Java 建造者模式(Builder Pattern)实战避坑指南
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址