当在多层继承结构（如 aentity → bentity → centity）中为子类添加 @builder 时，lombok 自动生成的 builder() 方法因返回类型不兼容（如 centitybuilder vs bentitybuilder）而引发编译错误；可通过 buildermethodname 自定义方法名避免重载冲突。
当在多层继承结构（如 aentity → bentity → centity）中为子类添加 @builder 时，lombok 自动生成的 builder() 方法因返回类型不兼容（如 centitybuilder vs bentitybuilder）而引发编译错误；可通过 buildermethodname 自定义方法名避免重载冲突。
在使用 Lombok 的 @Builder 注解进行链式构建器开发时，若存在多级继承关系（例如 CEntity extends BEntity extends AEntity），直接为每个子类标注 @Builder 会导致编译失败，典型错误如下：
error: builder() in CEntity cannot override builder() in BEntity return type CEntityBuilder is not compatible with BEntityBuilder
根本原因在于：Lombok 为每个 @Builder 类自动生成一个名为 builder() 的静态工厂方法，其返回类型为对应类的 XXXBuilder。由于 Java 不支持仅靠返回类型不同来重载方法，当 CEntity 继承 BEntity 时，父类已声明 public BEntityBuilder builder()，子类若再生成 public CEntityBuilder builder()，即构成非法重写（override），违反 JVM 方法签名规则。
✅ 推荐解决方案：使用 builderMethodName 显式指定子类构建器方法名
修改 CEntity 类，将 @Builder 的方法名设为唯一标识，避开与父类 builder() 的命名冲突：
@Data
@Entity
@Table(name = "C")
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
public class CEntity extends BEntity {
private Float w;
@Builder(builderMethodName = "ceBuilder") // ✅ 自定义方法名，避免冲突
public CEntity(BEntity bEntity, Float w) {
super(bEntity.getZ()); // 注意：此处原代码有误（bEntity 没有 getZ()），应为 getZ() 来自 BEntity？需确认字段逻辑
this.w = w;
}
}
此时生成的代码等效于：
public static CEntityBuilder ceBuilder() { // ← 方法名不再是 builder()
return new CEntityBuilder();
}
// 而父类 BEntity 的 builder() 仍保留，可正常使用：
// BEntity.builder().z(3.14).build();
// CEntity.ceBuilder().w(2.5f).build();
⚠️ 注意事项与最佳实践：
- 不要尝试手动继承或重写 Lombok 生成的 Builder 类（如 BEntityBuilder extends AEntityBuilder），这不仅违背 Lombok 设计初衷，还极易引发泛型、构造逻辑和字段同步问题；
- 若需统一构建入口，可考虑在顶层抽象类中定义受保护的 protected static
T buildFrom(...) 模板方法，或改用组合模式 + 构建器委托； - 确保构造函数参数逻辑正确：示例中 BEntity 构造器调用了 aEntity.getZ()，但 AEntity 并无 z 字段 —— 此处应为笔误，实际应为 aEntity.getX() 或其他合法字段，务必结合业务模型校验；
- 对于 JPA 实体继承，建议优先使用 @Inheritance(strategy = InheritanceType.SINGLE_TABLE) 配合 @DiscriminatorColumn，以降低 JOINED 策略下 builder 与 ORM 映射的耦合复杂度。
通过合理使用 builderMethodName，你既能保持继承结构的语义清晰性，又能安全启用 Lombok 的构建器能力，实现类型安全、可读性强且无编译风险的流式对象创建。
