如何用Jackson与Spring WebClient反序列化单值/数组混合JSON？

方案一：配置WebClient的Jackson解码器启用ACCEPT_SINGLE_VALUE_AS_ARRAY #

你之前尝试启用ACCEPT_SINGLE_VALUE_AS_ARRAY未生效，核心原因是没有将该配置应用到WebClient专属的Jackson解码器中。需要在构建WebClient时，自定义解码器并开启特性：

// 配置ObjectMapper，启用单值自动转数组特性
ObjectMapper objectMapper = new ObjectMapper();
objectMapper.enable(DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY);

// 构建自定义Jackson解码器
Jackson2JsonDecoder jacksonDecoder = new Jackson2JsonDecoder(objectMapper, MediaType.APPLICATION_JSON);

// 替换WebClient默认解码器
WebClient client = WebClient.builder()
        .codecs(configurer -> {
            configurer.defaultCodecs().jackson2JsonDecoder(jacksonDecoder);
        })
        .build();

配置完成后，原有的bodyToMono(typeRef)代码无需修改，Jackson会自动将单个对象响应转为包含该对象的List，完美兼容两种响应格式。

方案二：手动解析JsonNode后转换（按需兼容场景） #

如果需要针对特定接口单独处理，可先将响应体读取为JsonNode（仅消费一次响应体），判断类型后再转换为目标List：

WebClient client;
ParameterizedTypeReference<List<T>> typeRef;
ObjectMapper objectMapper = new ObjectMapper(); // 建议复用全局配置的ObjectMapper

client.get().uri(...)
        .exchangeToMono(response -> {
            return response.bodyToMono(JsonNode.class)
                    .map(jsonNode -> {
                        List<T> result;
                        if (jsonNode.isArray()) {
                            // 数组节点直接转换为List
                            result = objectMapper.convertValue(jsonNode, typeRef.getType());
                        } else {
                            // 单个对象节点包装为单元素List
                            Class<T> itemType = (Class<T>) ((ParameterizedType) typeRef.getType()).getActualTypeArguments()[0];
                            T singleItem = objectMapper.convertValue(jsonNode, itemType);
                            result = Collections.singletonList(singleItem);
                        }
                        return result;
                    });
        });

核心优势： #

• 避免了多次调用bodyToMono导致的响应体已消费问题
• 通过typeRef.getType()动态获取泛型实际类型，适配任意T的转换需求

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