使用ParameterizedTypeReference的泛型WebClient调用空指针问题排查

你遇到的NullPointerException核心原因是泛型类型不匹配导致反序列化失败：

1. 你使用ParameterizedTypeReference<ResponseEnvelope<String>>期望响应数据是String类型，但WebService返回的是不同结构的JSON（单个对象、数组），这些JSON无法直接被反序列化为String。Jackson序列化器在处理这种不匹配时，会将ResponseEnvelope中的数据字段设为null，后续访问该字段就会触发空指针异常。
2. 不同alias返回的JSON结构差异极大：
   • isActive返回单个JSON对象{"isActive":true}
   • 其他alias返回JSON数组（如rolesAlias返回角色数组）
     用统一的String类型承载这些复杂结构完全不适用。

根据不同alias的返回结构，使用对应的ParameterizedTypeReference：

1. 定义对应实体类（推荐，类型安全） #

先为数组类型的返回结果创建实体类，比如：

// Role.java
public class Role {
    private String id;
    private String name;
    private String description;
    // 生成getter、setter、构造方法
}

// Action.java
public class Action {
    private String id;
    private String name;
    // 生成getter、setter、构造方法
}

然后针对不同alias调用时使用匹配的类型：

• 处理isActive（返回单个对象）：

ResponseEnvelope<Map<String, Boolean>> response = webClient.get()
    .uri("your-service-url?alias=isActive")
    .retrieve()
    .bodyToMono(new ParameterizedTypeReference<ResponseEnvelope<Map<String, Boolean>>>() {})
    .block();
Boolean isActive = response.getData().get("isActive");

• 处理rolesAlias（返回角色数组）：

ResponseEnvelope<List<Role>> response = webClient.get()
    .uri("your-service-url?alias=rolesAlias")
    .retrieve()
    .bodyToMono(new ParameterizedTypeReference<ResponseEnvelope<List<Role>>>() {})
    .block();
List<Role> roles = response.getData();

2. 使用Object类型兼容所有结构（不推荐，类型不安全） #

如果不想创建多个实体类，可以用Object作为泛型参数，后续再根据alias做类型转换：

ResponseEnvelope<Object> response = webClient.get()
    .uri("your-service-url?alias={alias}", alias)
    .retrieve()
    .bodyToMono(new ParameterizedTypeReference<ResponseEnvelope<Object>>() {})
    .block();

if ("isActive".equals(alias)) {
    Map<String, Boolean> data = (Map<String, Boolean>) response.getData();
    // 业务处理逻辑
} else if ("rolesAlias".equals(alias)) {
    List<Map<String, String>> data = (List<Map<String, String>>) response.getData();
    // 业务处理逻辑
}

3. 统一WebService响应结构（需后端配合） #

如果可以协调后端修改WebService，让所有alias返回统一结构的响应（比如无论结果是单个值还是数组，都用数组包裹），这样就能用单一的泛型类型处理所有情况。

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