Spring Boot WebClient请求对象列表时编解码异常问题求助

1. 核对双方Model类一致性 #

• 确保字段名、数据类型完全匹配，注意JSON大小写敏感（若对方用了非驼峰命名，需通过@JsonProperty指定对应字段名）
• 检查是否存在序列化差异：比如一方字段用transient或@JsonIgnore修饰，另一方未做对应处理
• 确认Model类有无参构造函数：Jackson默认依赖无参构造反序列化，若仅存在带参构造，需添加@NoArgsConstructor（Lombok）或手动实现
• 正确处理泛型列表：WebClient接收列表时不能直接用Class<List<Interface>>，必须用ParameterizedTypeReference明确泛型类型：

  List<Interface> result = webClient.get()
      .uri("/api/interfaces")
      .retrieve()
      .bodyToMono(new ParameterizedTypeReference<List<Interface>>() {})
      .block();
  

2. 统一JSON序列化配置 #

• 对齐日期/时间类型处理：若Model包含LocalDateTime等JDK8时间类型，双方需都引入jackson-datatype-jsr310依赖，且序列化格式一致（比如统一用ISO8601）
• 同步枚举序列化规则：若Model存在枚举，确保双方枚举值、序列化方式（如@JsonValue注解）完全一致
• 处理未知字段：若对方返回的JSON包含本地Model未定义的字段，可在Model类添加@JsonIgnoreProperties(ignoreUnknown = true)避免解析失败

3. 捕获原始JSON定位问题 #

• 在WebClient调用中打印对方返回的原始JSON，对比Postman结果是否一致：

  webClient.get()
      .uri("/api/interfaces")
      .retrieve()
      .bodyToMono(String.class)
      .doOnNext(rawJson -> System.out.println("原始响应JSON: " + rawJson))
      .map(rawJson -> new ObjectMapper().readValue(rawJson, new TypeReference<List<Interface>>() {}))
      .block();
  

• 用打印出的JSON直接本地反序列化，复现异常并定位具体出错字段

4. 检查WebClient编解码器配置 #

• 若自定义了WebClient编解码器，确认ObjectMapper配置正确，避免开启了如ACCEPT_SINGLE_VALUE_AS_ARRAY等可能干扰列表解析的规则
• 尝试使用Spring Boot自动配置的默认WebClient实例，排除自定义编解码器的影响

5. 验证依赖版本兼容性 #

• 确保双方Spring Boot版本均为3.0.x，避免Jackson版本差异导致的兼容问题
• 检查本地项目jackson-core、jackson-databind、jackson-annotations版本与Spring Boot 3.0依赖的版本一致，排除依赖冲突

6. 分析异常堆栈细节 #

• 从CodecException堆栈中提取具体错误信息：
  • 若提示Cannot deserialize value of type java.util.ArrayList from Object value，说明对方返回的是单个对象而非列表，需核对接口返回格式
  • 若提示Unrecognized field "xxx"，说明存在未匹配的字段，可通过@JsonIgnoreProperties忽略或补充对应字段

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