Spring RestTemplate泛型responseType传递及CandyStore配置问题

核心原因：Java泛型的类型擦除 #

Java泛型是编译时特性，编译完成后所有泛型参数信息会被擦除（Type Erasure）。运行时，CandyWrapper<Skittle>实例的getClass()返回的就是CandyWrapper.class，无法区分具体的泛型参数Skittle，这就是直接拿instance.getClass()无效的根本原因。

RestTemplate的exchange方法如果传入Class类型，只能处理无泛型或泛型参数被擦除的类型；要处理带具体泛型参数的CandyWrapper<Skittle>，必须用参数化类型引用来保留泛型信息。

解决方案1：修改CandyStore使用ParameterizedTypeReference #

这是最简洁的Spring风格方案，直接利用Spring提供的ParameterizedTypeReference规避类型擦除问题：

步骤1：重构CandyStore类 #

public class CandyStore<T> {

    private final RestTemplate restTemplate;
    private final ParameterizedTypeReference<CandyWrapper<T>> typeReference;
    String candyFactoryUrl;

    // 构造方法改为接收ParameterizedTypeReference
    public CandyStore(ParameterizedTypeReference<CandyWrapper<T>> typeReference, RestTemplate restTemplate, String factoryUrl) {
        this.typeReference = typeReference;
        this.restTemplate = restTemplate;
        this.candyFactoryUrl = factoryUrl;
    }

    public CandyWrapper<T> getCandies(){
        HttpEntity<Void> request = new HttpEntity<>(null);
        ResponseEntity<CandyWrapper<T>> response = restTemplate.exchange(
                candyFactoryUrl,
                HttpMethod.GET,
                request,
                typeReference
        );
        return response.getBody();
    }
}

步骤2：配置Skittle对应的Bean #

通过匿名内部类创建ParameterizedTypeReference，匿名内部类的字节码会保留泛型参数信息：

@Bean
public CandyStore<Skittle> skittleCandyStore(RestTemplate restTemplate, @Value("${candy.factory.skittle.url}") String skittleUrl){
    ParameterizedTypeReference<CandyWrapper<Skittle>> typeRef = new ParameterizedTypeReference<>() {};
    return new CandyStore<>(typeRef, restTemplate, skittleUrl);
}

解决方案2：保留原有Class参数设计（不推荐） #

如果必须维持原有的Class<CandyWrapper<T>>参数设计，可以通过反射手动构造参数化类型，但这种方式存在类型安全风险：

步骤1：添加工具方法构造参数化类型 #

public static <T> Class<CandyWrapper<T>> getCandyWrapperClass(Class<T> candyType) {
    // 构造ParameterizedType实例
    ParameterizedType parameterizedType = ParameterizedTypeImpl.make(
            CandyWrapper.class,
            new Type[]{candyType},
            null
    );
    // 通过反射强制转换为Class类型
    return (Class<CandyWrapper<T>>) Class.forName(parameterizedType.getRawType().getTypeName());
}

步骤2：配置Bean时调用工具方法 #

@Bean
public CandyStore<Skittle> skittleCandyStore(RestTemplate restTemplate, String skittleUrl){
    Class<CandyWrapper<Skittle>> wrapperClass = getCandyWrapperClass(Skittle.class);
    return new CandyStore<>(wrapperClass, restTemplate, skittleUrl);
}

注意：这种方式本质是强制类型转换，运行时可能引发类型转换异常，仅适合必须兼容原有代码的场景。

泛型核心概念梳理 #

• 类型擦除：Java泛型仅在编译期生效，编译后字节码中不会保留泛型参数，所有泛型类型都会被替换为其上限类型（比如T会被替换为Object）。
• ParameterizedType：表示参数化类型（如CandyWrapper<Skittle>）的接口，通过反射可获取这类类型的具体泛型参数。
• ParameterizedTypeReference：Spring提供的工具类，通过匿名内部类的方式保留泛型信息，专门用于RestTemplate、WebClient等需要处理泛型响应的场景。

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