WebClient调用GET API返回对象部分属性为null问题排查

• 最核心问题是响应结构与反序列化目标类型不匹配：下游接口返回的最外层是JSON数组（格式为[{...}]），但代码中直接使用bodyToMono(CuCoPerson.class)将响应解析为单个CuCoPerson实体。Jackson在遇到JSON数组尝试反序列化为普通POJO时，仅能识别绑定第一个元素中匹配度较高的字段，其余字段会直接填充为null，和你遇到的仅externalId有值、其余字段为null的现象完全吻合。
• 未正确声明集合泛型类型：即使要解析数组结构，直接传入实体类CuCoPerson.class会触发Java泛型擦除问题，导致Jackson无法正确识别集合内部的实体类型，进一步加剧字段映射失败。
• 可选排查项：如果修正类型后仍有字段映射为null，检查WebClient关联的Jackson配置是否设置了全局非驼峰命名策略（例如下划线转驼峰规则），全局命名规则和下游返回的字段名不匹配时，也会出现字段无法绑定、赋值为null的问题。

1. 修正反序列化类型，匹配下游返回的数组结构，先解析为实体集合再取首个元素返回即可，代码参考：

@GetMapping("/getCucoId/{cucoId}")
public Mono<CuCoPerson> getCucoRelationById(@PathVariable Integer cucoId, @AuthenticationPrincipal Principal principal) {
    return webClient.get()
            .uri("/getRelationByCucoId/" + cucoId)
            .header(HttpHeaders.AUTHORIZATION, "Bearer eyJraWQiOi...")
            .retrieve()
            // 使用ParameterizedTypeReference声明泛型集合类型，避免泛型擦除
            .bodyToMono(new ParameterizedTypeReference<List<CuCoPerson>>() {})
            // 取集合首个元素，空集合直接返回null
            .map(personList -> personList.isEmpty() ? null : personList.get(0));
}

2. 若修正类型后仍存在字段为null的情况：
   • 取消你POJO类中@JsonProperty注解的注释，显式指定每个字段对应的JSON key，避免全局命名策略干扰字段映射。
   • 检查传入的cucoId参数是否正确，确认下游接口是否能根据该ID查询到完整数据，排除业务层面查询无结果导致字段为null的情况。
3. 优化建议：不要在代码中硬编码鉴权Token，建议通过WebClient的ExchangeFilterFunction统一注入鉴权头，避免Token过期导致接口返回异常。

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