Java泛型通过Builder调用时默认转为Object类型的问题

问题现象 #

在实现GenericListDTO的静态方法just时，调用builder().dataList(dataList)出现IntelliJ编译错误：

Required type: Collection<?> Provided:Collection
必须通过双重强制转换才能临时消除错误，但这并非合理解决方案。

代码中的核心错误点 #

1. 构建器方法名不匹配 #

构建器类GenericListDTOBuilder中定义的集合设置方法是data()，但静态方法just里错误调用了不存在的dataList()——编译器找不到匹配的泛型方法，会退回到raw类型（无泛型）处理模式，导致无法识别Collection<DTO>的类型兼容性，进而报错。

// 构建器中实际定义的方法
public GenericListDTOBuilder<DTO> data(@NotNull Collection<DTO> data) {
    this.dataList = dataList; // 此处还存在赋值错误
    return this;
}

// 静态方法中错误调用了不存在的方法
return builder().dataList(dataList).total(dataList.size()).build();

2. 构建器内部赋值错误 #

data()方法里错误地将成员变量dataList赋值给自身，而非传入的参数data，这会导致集合数据无法正确设置：

// 错误写法
this.dataList = dataList;
// 正确写法
this.dataList = data;

3. build方法变量引用错误 #

build方法中引用了未定义的this.data和this.validUntil，但构建器的成员变量是dataList和total，这会引发编译错误，进一步干扰泛型类型推断：

// 错误写法
return new GenericListDTO<>(this.data, this.total, this.validUntil);
// 正确写法（匹配GenericListDTO构造参数）
return new GenericListDTO<>(this.dataList, this.total);

修复后的完整代码示例 #

GenericListDTO核心代码 #

@XmlElement
@NotNull
private Collection<DTO> dataList;
@XmlElement
private int totObjs;

// 对应构建器的构造方法
public GenericListDTO(Collection<DTO> dataList, int totObjs) {
    this.dataList = dataList;
    this.totObjs = totObjs;
}

public static <DTO> GenericListDTOBuilder<DTO> builder() { 
   return new GenericListDTOBuilder<>(); 
}

修复后的构建器类 #

public static class GenericListDTOBuilder<DTO> {
    private Collection<DTO> dataList;
    private int total;

    public GenericListDTOBuilder<DTO> data(@NotNull Collection<DTO> data) {
        this.dataList = data; // 修正赋值逻辑
        return this;
    }

    public GenericListDTOBuilder<DTO> total(int total) {
        this.total = total;
        return this;
    }

    public GenericListDTO<DTO> build() {
        return new GenericListDTO<>(this.dataList, this.total); // 修正变量引用
    }
}

修复后的静态方法just #

@NotNull
public static <DTO> GenericListDTO<DTO> just(@NotNull Collection<DTO> dataList) {
    // 调用正确的方法名，泛型类型推断正常工作
    return builder().data(dataList).total(dataList.size()).build();
}

类型推断错误的根源 #

当编译器找不到匹配的泛型方法（如调用了不存在的dataList()），会自动忽略泛型参数，以raw类型处理构建器。此时编译器无法推断方法的参数类型应为Collection<DTO>，反而默认要求Collection<?>，最终导致类型不匹配报错。修复方法名和内部变量引用后，编译器可正常识别泛型类型，无需强制转换即可通过编译。

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