使用Lombok @SuperBuilder时Stream.map的类型推断异常问题

先明确问题场景：MyEntity继承自抽象类BaseEntity，两者都使用Lombok 1.18.34版本的@SuperBuilder注解。直接在Stream的map方法里调用构建器时，编译器无法推断出正确的MyEntity类型，返回List<?>；但把构建逻辑抽成单独方法、或者直接赋值给变量/返回时就能正常推断。

代码复现 #

父类与子类代码 #

BaseEntity.java

@Getter
@Setter
@SuperBuilder
@ToString(onlyExplicitlyIncluded = true)
@EqualsAndHashCode
public abstract class BaseEntity {
    public abstract SomeType getSomeType();
}

MyEntity.java

@Value
@SuperBuilder
@ToString(onlyExplicitlyIncluded = true)
@EqualsAndHashCode(callSuper = true)
public class MyEntity extends BaseEntity {
    @Override
    public SomeType getSomeType() {
        return SomeType.SOMETHING;
    }
}

异常与正常场景对比 #

1. 异常场景：Stream map中直接构建，返回List<?>

// 返回类型为List<?>，而非期望的List<MyEntity>
someItems.stream()
    .map(item -> MyEntity.builder().build())
    .toList();

2. 正常场景1：构建逻辑抽为单独方法

private MyEntity getBuild(SomeItem item) {
    return MyEntity.builder().build();
}

// 正常返回List<MyEntity>
List<MyEntity> myEntities = someItems.stream()
    .map(this::getBuild)
    .toList();

3. 正常场景2：赋值/直接返回的差异

// 正常工作
public static List<MyEntity> creatingTheEntityFirst() {
    MyEntity build = MyEntity.builder().build();
    return List.of(build);
}

// 直接返回List.of(...)正常，但先赋值给变量会变成List<?>
public static List<MyEntity> creatingEntityInAList(List<String> strings) {
    List<?> build = List.of(MyEntity.builder().build()); // 类型为List<?>
    return build; // 编译报错
    return List.of(MyEntity.builder().build()); // 此语句正常
}

核心原因：泛型推断的上下文约束问题 #

Lombok为@SuperBuilder生成的build()方法是泛型方法，签名大致为public abstract <C extends BaseEntity> C build()。编译器需要根据调用build()时的上下文约束来确定泛型参数C的具体类型，一旦上下文缺失就会推断失败。

1. Stream map中的推断卡壳 #

在map(item -> MyEntity.builder().build())这个Lambda表达式中，编译器陷入双向依赖的困境：

• 它需要先确定Lambda的返回类型，才能明确map方法的泛型参数（即Stream转换后的元素类型）；
• 但Lambda内部的build()方法，又需要根据map的泛型参数来确定自身的返回类型。
  两边互相等待对方先明确，编译器只能退而求其次，使用最宽泛的通配符?，最终导致toList()返回List<?>。

2. 抽方法/直接赋值的上下文明确 #

• 抽成单独方法时，方法的返回值MyEntity给了build()明确的类型目标，编译器直接就能确定build()的返回类型；
• 先赋值给MyEntity build = ...时，赋值目标的类型直接约束了build()的返回类型；
• 直接return List.of(MyEntity.builder().build())时，return的目标类型List<MyEntity>会层层传递：先告诉List.of()要接收MyEntity类型元素，再传递给build()确定其返回类型；但如果先把List.of(...)赋值给无泛型约束的变量，这个传递链条断裂，build()的类型推断就会退化，变成List<?>。

解决办法 #

除了抽取单独方法外，还可以通过显式指定类型帮编译器明确方向：

1. 显式指定map的泛型参数：

someItems.stream()
    .<MyEntity>map(item -> MyEntity.builder().build())
    .toList();

2. 显式指定build()的泛型参数：

someItems.stream()
    .map(item -> MyEntity.builder().<MyEntity>build())
    .toList();

内容的提问来源于stack exchange，提问作者syydi