在Java开发中，Lombok可以大幅减少样板代码，但当我们在泛型类上同时使用@Builder注解时，经常会出现编译器无法正确推导类型、生成的构建器返回类型不匹配等问题。理解其背后的机制并采用合适的写法，是避免踩坑的关键。
冲突产生的原因
Lombok在编译期通过注解处理器生成代码。对于泛型类，类型参数在运行时会被擦除，而Lombok早期版本在生成Builder内部类时，未能很好地保留泛型信息，导致构建器方法返回的原始类型而非参数化类型。此外，如果类同时包含自定义构造器和Lombok注解，也可能因为代码生成顺序问题引发冲突。
典型错误示例
下面这段代码在部分Lombok版本中会导致构建器类型推导异常：
import lombok.Builder;
import lombok.Data;
@Data
@Builder
public class Box<T> {
private T value;
}
// 使用处
Box<String> box = Box.<String>builder().value("test").build(); // 某些版本报错
解决方案一：使用@Builder注解于构造器
将@Builder直接标注在构造器上，并配合@AllArgsConstructor，可以让Lombok更明确地处理泛型：
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@Data
@AllArgsConstructor
public class Box<T> {
private T value;
@Builder
public static <T> Box<T> of(T value) {
return new Box<>(value);
}
}
解决方案二：自定义Builder类
当自动生成无法满足需求时，可以手动编写内部Builder类，完全控制泛型传递：
public class Box<T> {
private T value;
private Box(T value) {
this.value = value;
}
public static <T> BoxBuilder<T> builder() {
return new BoxBuilder<>();
}
public static class BoxBuilder<T> {
private T value;
public BoxBuilder<T> value(T value) {
this.value = value;
return this;
}
public Box<T> build() {
return new Box<>(value);
}
}
}
解决方案三：升级Lombok版本
新版本Lombok已经优化了对泛型类的Builder支持。在项目中将Lombok升级到1.18.20以上，很多历史冲突会自然消失。同时建议在IDE中启用注解处理，并清理重新编译。
版本依赖示例
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.30</version>
<scope>provided</scope>
</dependency>
总结建议
面对Lombok泛型类与Builder模式的冲突，优先尝试升级Lombok与规范注解位置；若仍报错，使用静态工厂或手写Builder是最稳妥的方式。这样既能保留代码可读性，也能彻底规避类型推导问题。