Spring Boot使用WebClient获取Strapi v4数据遇编码问题求助

原因分析 #

• 这确实是WebClient无法获取深层数据的直接原因：WebClient对URL参数做了双重编码——当你传入已编码的populate=%2A时，它会把%再次编码为%25，最终参数变成populate=%252A。
• Strapi无法识别这个错误的参数值，因此不会返回你需要的深层关联数据。
• 而HttpClient的URI.create()会直接使用传入的URL字符串，不会额外编码，所以参数能正确传递给Strapi。

解决方案 #

方案1：使用WebClient的UriBuilder构建请求（推荐） #

直接传入原始参数值，让WebClient自动处理正确的编码，避免手动编码后被二次处理：

Mono<String> mon = webClient.get()
    .uri(uriBuilder -> uriBuilder
        .path("/api/customer")
        .queryParam("filters[state][$eq]", "karnataka")
        .queryParam("populate", "*") // 直接传原始*，WebClient会正确编码为%2A
        .build())
    .accept(MediaType.APPLICATION_JSON)
    .retrieve()
    .bodyToMono(String.class);

方案2：使用UriComponentsBuilder处理预编码URL #

如果必须使用预构建的urlToUse字符串，可以通过UriComponentsBuilder标记已编码部分，避免WebClient重复编码：

// 构建UriComponents时指定true，表示保留已有的编码
UriComponents uriComponents = UriComponentsBuilder.fromUriString(urlToUse)
    .build(true);

Mono<String> mon = webClient.get()
    .uri(uriComponents.toUri())
    .accept(MediaType.APPLICATION_JSON)
    .retrieve()
    .bodyToMono(String.class);

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