Spring WebFlux 中如何获取 WebClient 调用的原始响应字符串
排查WebClient无法获取原始响应JSON的方案
问题根因
你之前两种写法拿不到有效内容,本质是两个典型的踩坑点:
retrieve()返回的是响应式包装对象,直接调toString()只会打印对象的内存哈希地址。这类懒加载的响应式流不主动订阅、不触发实际网络请求的话,根本不会加载真实响应内容- WebClient的响应体是单向一次性字节流,一旦被解析器消费读取,就无法二次读取。哪怕换成
bodyToMono(String.class),如果是把流先拿去解析成Responseclass,再回头读字符串的话,流已经空了,自然拿不到内容 - 如果直接写
webClient.post()...bodyToMono(String.class).toString(),本质是拿Mono实例的默认字符串输出,没有调用block()触发请求执行,当然拿不到真实响应
可落地的实现方案
方案1:纯临时调试场景(不需要保留原有业务类返回逻辑)
直接修改链式调用,将解析目标替换为String,一定要显式调用block()触发请求执行,不要直接对Mono对象调toString:
// 临时调试用,直接拿到原始响应字符串 String rawResponse = webClient .post() .uri("whatever.com") .header("Authorization", "Bearer " + authToken) .header("userId", CLIENT_ID) .header("clientRequestId", requestId) .bodyValue(bodyValue()) .retrieve() .bodyToMono(String.class) .block(); // 直接打印即可拿到完整原始JSON log.info("接口原始响应内容:{}", rawResponse);
方案2:不改动原有业务返回逻辑,同时捕获原始响应
如果需要保持原方法返回Responseclass对象的逻辑不变,只是额外导出原始JSON做排查,就不要重复多次读取响应流,改成单次读取流获取原始JSON,再在内存中把JSON转成业务类的写法,完全不破坏原有功能:
return webClient .post() .uri("whatever.com") .header("Authorization", "Bearer " + authToken) .header("userId", CLIENT_ID) .header("clientRequestId", requestId) .bodyValue(bodyValue()) .retrieve() // 单次读取流拿到原始JSON .bodyToMono(String.class) // 拿到原始JSON后直接打印,完成调试需求 .doOnNext(rawJson -> log.info("导出原始接口响应:{}", rawJson)) // 用内存中的JSON反序列化成原有业务类,不会出现流消费问题 .map(rawJson -> objectMapper.readValue(rawJson, Responseclass.class)) .block();
方案3:全局通用调试能力(无需每次修改业务代码)
如果需要长期在调试环境下导出所有WebClient调用的原始响应,可以给WebClient实例加全局交换过滤器,统一拦截所有响应:
注意:在过滤器中读取响应体后,一定要把缓存的响应体重新包装回响应对象,否则下游业务代码会因为流被提前消费拿到空响应
WebClient debugWebClient = WebClient.builder() .baseUrl("项目统一的接口基础域名") .filter((request, next) -> next.exchange(request) .flatMap(response -> response.bodyToMono(byte[].class) .flatMap(responseBytes -> { // 统一打印原始响应内容 String rawContent = new String(responseBytes, StandardCharsets.UTF_8); log.info("接口请求URL:{},原始响应内容:{}", request.url(), rawContent); // 重新构造响应对象,把缓存的响应体传递给下游 ClientResponse passthroughResponse = ClientResponse.from(response) .body(responseBytes) .build(); return Mono.just(passthroughResponse); }) ) ) .build();
内容的提问来源于stack exchange,提问作者Steve
相关产品推荐
相关产品推荐

