Spring WebFlux中WebClient泛型类型响应返回null的解决方法

问题的核心确实是Java的类型擦除：当你直接传递MyResponse<MyObject>.class时，泛型参数<MyObject>的类型信息在运行时会被擦除，反序列化框架（如Jackson）无法识别MyResponse中data字段的具体类型，只能生成空对象或未正确填充的实例。

正确实现方式：使用ParameterizedTypeReference匿名内部类 #

ParameterizedTypeReference的匿名内部类会在编译时保留泛型类型的完整信息（通过类字节码的Signature属性），反序列化框架可以通过反射读取这些信息，从而正确解析嵌套的泛型字段。

步骤1：定义泛型响应类

假设你的响应类结构如下：

public class MyResponse<T> {
    private String code;
    private String message;
    private T data;

    // 生成getter、setter、无参/全参构造方法
}

步骤2：构造WebClient请求

直接在bodyToMono中传入ParameterizedTypeReference的匿名内部类实例：

WebClient webClient = WebClient.create("https://your-target-api.com");

Mono<MyResponse<MyObject>> responseMono = webClient.get()
        .uri("/api/resource")
        .retrieve()
        // 关键：使用匿名内部类保留泛型类型信息
        .bodyToMono(new ParameterizedTypeReference<MyResponse<MyObject>>() {});

// 订阅处理响应
responseMono.subscribe(response -> {
    MyObject data = response.getData();
    // 业务逻辑处理
});

常见错误规避 #

不要直接实例化ParameterizedTypeReference（非匿名内部类），比如以下写法是无效的：

// 错误：无法保留泛型类型信息
ParameterizedTypeReference<MyResponse<MyObject>> typeRef = new ParameterizedTypeReference<>();
.bodyToMono(typeRef);

只有匿名内部类的形式才能让JVM保留泛型的具体类型参数。

复用类型引用（可选） #

如果需要在多处复用同一泛型类型，可以将其定义为静态常量：

public class ApiClient {
    private static final ParameterizedTypeReference<MyResponse<MyObject>> MY_OBJECT_RESPONSE_TYPE =
            new ParameterizedTypeReference<MyResponse<MyObject>>() {};

    public Mono<MyResponse<MyObject>> fetchMyObject() {
        return WebClient.create("https://your-target-api.com")
                .get()
                .uri("/api/resource")
                .retrieve()
                .bodyToMono(MY_OBJECT_RESPONSE_TYPE);
    }
}

内容的提问来源于stack exchange，提问作者Кирилл Курда