本文介绍如何在使用 Lombok @Builder 时，对枚举类型字段（如 TestEnum）施加额外的业务约束（仅允许 ALPHA 或 BETA），无需手写完整 Builder，而是通过覆盖生成的 builder 方法并嵌入校验逻辑实现安全、简洁、可维护的构造控制。
本文介绍如何在使用 lombok `@builder` 时，对枚举类型字段（如 `testenum`）施加额外的业务约束（仅允许 `alpha` 或 `beta`），无需手写完整 builder，而是通过覆盖生成的 builder 方法并嵌入校验逻辑实现安全、简洁、可维护的构造控制。
在基于 Lombok 的构建器模式开发中，@Builder 能显著减少样板代码，但其默认校验能力有限——例如无法对 enum 字段做值域限制（如仅接受 ALPHA/BETA，排除 GAMMA）。此时，直接依赖 @NonNull 或 @NotNull 并不足够，因为它们只校验非空，不校验具体枚举值。
✅ 推荐方案：局部覆盖 Builder 方法（轻量、精准）
Lombok 允许你仅重写 Builder 中特定 setter 方法，而复用其余自动生成逻辑。只需确保方法签名与 Lombok 生成的一致（包括类名、方法名、参数类型），Lombok 将自动跳过该方法的生成，并采用你的实现：
@Builder(toBuilder = true)
public class Testing {
@NonNull private String id;
@NonNull private TestEnum test;
private String message;
// 手动提供 test() 方法，注入业务校验
public static class TestingBuilder {
public TestingBuilder test(@NonNull TestEnum test) {
if (test != TestEnum.ALPHA && test != TestEnum.BETA) {
throw new IllegalArgumentException(
"test must be either ALPHA or BETA, but got: " + test);
}
this.test = test;
return this;
}
}
}
? 关键细节说明：
- 类名必须为
TestingBuilder（主类名 +Builder）；- 方法名必须为
test（与字段名一致）；- 参数类型需完全匹配（含
@NonNull注解，Lombok 会识别并保留其语义）；- 返回
this以支持链式调用，且toBuilder()仍可正常工作。
⚠️ 进阶建议：强制全路径校验（防御性更强）
若业务要求所有构造方式（包括直接 new Testing(...)、反射、反序列化等）都必须满足约束，则应在构造器层面统一拦截，而非仅依赖 Builder：
public Testing(@NonNull String id, @NonNull TestEnum test, String message) {
if (test != TestEnum.ALPHA && test != TestEnum.BETA) {
throw new IllegalArgumentException(
"test must be either ALPHA or BETA, but got: " + test);
}
this.id = id;
this.test = test;
this.message = message;
}
// 禁用无参构造器（可选，配合 @RequiredArgsConstructor(staticName = "of") 更佳）
private Testing() { throw new UnsupportedOperationException(); }
此时建议移除 @Builder 的 toBuilder = true（或配合自定义 toBuilder 方法），避免绕过构造器校验。
✅ 总结与最佳实践
- ✅ 优先使用“局部覆盖 Builder 方法”：开发成本低、侵入性小、兼容
toBuilder()，适合大多数场景； - ✅ 校验信息应明确包含非法值（如示例中的
+ test），便于调试与日志追踪； - ❌ 避免自定义 Lombok 注解：Lombok 不支持运行时注解处理器与自定义校验逻辑的深度集成，易引发不可预测行为；
- ? 若项目已引入 Bean Validation（如
jakarta.validation），可结合@Constraint自定义枚举校验注解，但需额外配置验证触发点（如@Valid+Validator.validate()），不适用于 Builder 构造阶段。
通过上述方式，你既能享受 Lombok 带来的生产力提升，又能严守业务规则边界，真正实现「约定优于配置」的工程化实践。
