大家好,我是 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. 主流框架的"链式门面"
| 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
- 也可以私信我
- 技术交流可通过个人主页联系
有些坑,一个人踩是事故;一起踩,就是经验 😎



