使用WebClient调用API进行认证时遭遇400 Bad Request错误（URI已确认正确）

嘿，我来帮你搞定这个WebClient调用返回400错误的问题。虽然你已经确认了URI正确，但400 Bad Request通常是请求本身的格式、参数或者序列化出了问题，咱们一步步来排查：

1. 检查请求体的序列化方式 #

你当前用了JSONObject作为请求体传入bodyValue，但Spring WebClient默认的Jackson编码器对org.json.JSONObject的支持并不够友好，可能会导致序列化后的JSON格式不符合API的预期。

推荐换成更适合的类型：

• 用Map传递参数：

  Map<String, String> credentials = new HashMap<>();
  credentials.put("login", "admin");
  credentials.put("password", "admin");
  
  String response = client.post()
          .uri(new URI("http://localhost:8080/rest/auth/v1/token:create"))
          .contentType(MediaType.APPLICATION_JSON)
          .accept(MediaType.APPLICATION_JSON)
          .bodyValue(credentials)
          .retrieve()
          .bodyToMono(String.class)
          .block();
  

• 创建专用的POJO类：

  // 定义请求体POJO
  class AuthRequest {
      private String login;
      private String password;
  
      // 构造方法、getter和setter
      public AuthRequest(String login, String password) {
          this.login = login;
          this.password = password;
      }
  
      // 省略getter和setter
  }
  
  // 调用时使用POJO
  AuthRequest credentials = new AuthRequest("admin", "admin");
  
  String response = client.post()
          .uri(new URI("http://localhost:8080/rest/auth/v1/token:create"))
          .contentType(MediaType.APPLICATION_JSON)
          .accept(MediaType.APPLICATION_JSON)
          .bodyValue(credentials)
          .retrieve()
          .bodyToMono(String.class)
          .block();
  

2. 捕获并查看完整的错误响应体 #

400错误的响应体里通常会包含API给出的具体拒绝原因（比如参数名不匹配、缺少必填项等），但默认的WebClientResponseException不会主动打印这些信息。你可以修改代码来捕获并打印响应体：

try {
    String response = client.post()
            .uri(new URI("http://localhost:8080/rest/auth/v1/token:create"))
            .contentType(MediaType.APPLICATION_JSON)
            .accept(MediaType.APPLICATION_JSON)
            .bodyValue(credentials)
            .retrieve()
            // 主动处理4xx错误，获取响应体
            .onStatus(HttpStatus::is4xxClientError, clientResponse ->
                clientResponse.bodyToMono(String.class)
                    .flatMap(errorBody -> Mono.error(new RuntimeException("API返回错误: " + errorBody)))
            )
            .bodyToMono(String.class)
            .block();
} catch (WebClientResponseException e) {
    System.out.println("完整错误响应体: " + e.getResponseBodyAsString());
    e.printStackTrace();
}

拿到具体的错误提示后，就能精准定位问题了。

3. 核对参数名和API要求 #

有时候API期望的参数名和你传递的不一致，比如它可能需要username而不是login，或者passwd而不是password。对照API文档仔细核对参数名称，确保完全匹配。

4. 检查请求头是否完整 #

虽然你设置了Content-Type和Accept，但有些API可能还要求其他必填请求头（比如X-API-Version、X-Requested-With等）。查看API文档的请求头要求，补充必要的头部信息：

String response = client.post()
        .uri(new URI("http://localhost:8080/rest/auth/v1/token:create"))
        .header("X-API-Version", "1.0") // 示例：添加额外请求头
        .contentType(MediaType.APPLICATION_JSON)
        .accept(MediaType.APPLICATION_JSON)
        .bodyValue(credentials)
        .retrieve()
        .bodyToMono(String.class)
        .block();

按照这些步骤排查，应该能很快找到问题所在！

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