Spring WebClient 的 toEntityList(String.class) 无法正确解析 JSON 字符串数组（如 ["a","b"]），而是将其整体当作单个字符串返回；这是框架有意设计的行为，需改用 bodyToMono(String[].class) 或适配 NDJSON 格式来解决。
spring webclient 的 `toentitylist(string.class)` 无法正确解析 json 字符串数组（如 `["a","b"]`），而是将其整体当作单个字符串返回；这是框架有意设计的行为，需改用 `bodytomono(string[].class)` 或适配 ndjson 格式来解决。
在使用 Spring WebFlux 的 WebClient 消费 REST 接口时，若后端返回的是纯字符串数组的 JSON（例如 ["D0000019","D0000017"]），直接调用 toEntityList(String.class) 会意外地返回一个仅含单个元素的 List<String>，该元素即为原始 JSON 字符串文本本身（如 "["D0000019","D0000017"]"），而非解析后的字符串列表。这不是 Bug，而是 Spring Framework 的明确设计决策。
根据 Spring 官方文档与核心开发者 Rossen Stoyanchev 的说明，Jackson 编解码器在处理 String.class 与 application/json 媒体类型时存在语义歧义：
- 它既可能表示「一个被 JSON 序列化的字符串」（如 "hello"），
- 也可能表示「一个 JSON 数组」（如 ["a","b"]）。
为保持一致性并避免流式场景（如 SSE）下的歧义，Spring 默认将 String.class 视为“JSON 字符串字面量”而非“JSON 数组容器”。这意味着 toEntityList(String.class) 实际上不会触发 JSON 反序列化，而只是将响应体原样封装。
✅ 正确解决方案如下：
方案一：使用 bodyToMono(String[].class)（推荐）
String[] ids = webClient.get()
.uri("/myEndpoint")
.accept(MediaType.APPLICATION_JSON)
.retrieve()
.bodyToMono(String[].class) // 直接反序列化为字符串数组
.block(); // 阻塞获取（生产环境建议用 Mono.flatMap 等非阻塞链式调用）
List<String> idList = Arrays.asList(ids); // 转为 List（如需）✅ 优势：简洁、类型安全、完全利用 Jackson 自动反序列化能力。
⚠️ 注意：bodyToFlux(String[].class) 不适用——它会把整个数组当作一个元素发射，而非拆分为多个字符串。
方案二：服务端改用 NDJSON / JSON Lines（适合流式或高并发场景）
若可修改服务端，将响应格式改为换行分隔的 JSON（NDJSON）：
"D0000019" "D0000017" "D0000016"
客户端配置：
List<String> ids = webClient.get()
.uri("/myEndpoint")
.accept(MediaType.APPLICATION_NDJSON) // 显式声明媒体类型
.retrieve()
.bodyToFlux(String.class) // 每行自动解析为一个 String
.collectList()
.block();✅ 优势：天然支持流式处理、内存友好；Jackson 默认支持 NDJSON（无需额外配置）。
? 服务端示例（Spring MVC）：@GetMapping(value = "/myEndpoint", produces = MediaType.APPLICATION_NDJSON_VALUE) public ResponseEntity<Flux<String>> getIds() { return ResponseEntity.ok(Flux.fromIterable(Arrays.asList("D0000019", "D0000017"))); }
❌ 避免踩坑
- 不要使用 toEntityList(String.class) 或 toEntityList(Object.class) 处理字符串数组；
- 不要尝试手动 new ObjectMapper().readValue(responseBody, List.class) —— 这绕过了 WebClient 的编解码器链，丢失错误处理与类型推导能力；
- 若必须保留 List<String> 类型，可在 bodyToMono(String[].class) 后链式转换：
.map(Arrays::asList)。
总结：Spring 的行为是权衡后的合理设计。面对 JSON 字符串数组，首选 bodyToMono(String[].class)，语义清晰、零配置、完全符合 Jackson 反序列化预期；如需扩展性与流式支持，再考虑 NDJSON 协议升级。
