当在lombok构建器继承链（如aentity → bentity → centity）中为子类重复使用@builder时，因自动生成的builder()方法签名冲突（返回类型不兼容）导致编译失败，可通过buildermethodname自定义方法名解决。
当在lombok构建器继承链（如aentity → bentity → centity）中为子类重复使用@builder时，因自动生成的builder()方法签名冲突（返回类型不兼容）导致编译失败，可通过buildermethodname自定义方法名解决。
在基于Lombok的分层实体建模中，若多个继承层级均使用@Builder注解（例如BEntity和CEntity都标注了@Builder），Lombok会为每个类生成一个同名的静态工厂方法builder()，其返回类型分别为BEntityBuilder和CEntityBuilder。由于Java不允许子类重写父类方法时仅改变返回类型（协变返回需满足继承关系，而CEntityBuilder并非BEntityBuilder的子类），编译器将报错：
error: builder() in CEntity cannot override builder() in BEntity return type CEntityBuilder is not compatible with BEntityBuilder
根本原因在于：Lombok默认为每个@Builder生成独立的内部Builder类及同名静态方法，但未自动建立Builder类之间的继承关系，导致builder()方法在继承链中无法合法重载。
✅ 正确解决方案是避免方法名冲突，利用Lombok提供的builderMethodName属性为子类指定唯一的方法名：
// BEntity 保持默认 builder() 方法（返回 BEntityBuilder）
@Data
@Entity
@Table(name = "B")
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
@Inheritance(strategy = InheritanceType.JOINED)
public class BEntity extends AEntity {
private Double z;
@Builder
public BEntity(AEntity aEntity, Double z) {
super(aEntity.getId(), aEntity.getX(), aEntity.getY()); // 注意：原代码中 aEntity.getZ() 有误，AEntity 无 z 字段
this.z = z;
}
}
// CEntity 改用自定义 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.getId(), bEntity.getX(), bEntity.getY(), bEntity.getZ()); // 补全父类构造参数
this.w = w;
}
}
调用方式变为：
CEntity entity = CEntity.ceBuilder()
.bEntity(BEntity.builder().x(10).y(20).z(3.14).build())
.w(1.0f)
.build();
⚠️ 注意事项：
- builderMethodName仅修改静态工厂方法名，不影响Builder类本身名称（仍为CEntityBuilder）；
- 若需链式调用父类字段，确保构造函数正确委托父类参数（如示例中修复了AEntity.getY()调用，并补充了BEntity完整构造）；
- 不建议手动继承Lombok生成的Builder类（如BEntityBuilder extends AEntityBuilder），因其为私有嵌套类且无公共API保障；
- 更健壮的设计可考虑统一使用顶层@Builder + toBuilder = true，或改用手动Builder模式以获得完全控制权。
总结：Lombok的@Builder在继承场景下需显式规避命名冲突，builderMethodName是最简洁、安全的官方推荐方案。
