服务器返回400错误的排查思路

当 HttpResponse 的 isOk() 返回 false 且状态码为 400（Bad Request）时，通常表示客户端发送的请求存在语法或参数错误。要获取更具体的错误原因，可以从以下几个地方排查：

1. 响应体（Response Body）

• 关键来源：服务器通常会在响应体中返回详细的错误信息（如 JSON/XML 格式的错误描述）。
• 获取方式：

  String errorBody = response.getBody(); // 直接读取响应体
  System.out.println("Error Body: " + errorBody);
  

• 注意：如果响应体是 JSON，可以解析特定字段（如 message、code）：

  import com.fasterxml.jackson.databind.JsonNode;
  import com.fasterxml.jackson.databind.ObjectMapper;
  
  ObjectMapper mapper = new ObjectMapper();
  JsonNode errorJson = mapper.readTree(errorBody);
  String errorMessage = errorJson.path("message").asText();
  

2. 响应头（Response Headers）

• 可能包含的线索：某些 API 会在响应头中附加错误信息（如 X-Error-Message、WWW-Authenticate）。
• 获取方式：

  Headers headers = response.getHeaders();
  for (Header header : headers) {
      System.out.println(header.getName() + ": " + header.getValue());
  }
  

3. HTTP 状态码的扩展信息

• 状态码 400 的常见子类型：
  • 400 Bad Request：可能因缺失必填参数、参数类型错误、请求体格式无效等。
  • 某些框架（如 Spring）会返回更具体的 4xx 状态码，如 422 Unprocessable Entity（数据验证失败）。

4. 服务器日志

• 后端调试：如果可能，检查服务器日志，通常会有更详细的错误堆栈或验证失败原因。

5. 框架/工具特定的错误信息

• RestTemplate（Spring）：捕获 HttpClientErrorException：

  try {
      restTemplate.getForEntity(url, String.class);
  } catch (HttpClientErrorException e) {
      System.out.println("Status: " + e.getStatusCode());
      System.out.println("Error Body: " + e.getResponseBodyAsString());
  }
  

• OkHttp/Retrofit：通过 response.errorBody()：

  try {
      Response response = client.newCall(request).execute();
  } catch (IOException e) {
      if (response.code() == 400) {
          String errorBody = response.body().string(); // 注意：只能调用一次
      }
  }
  

6. 调试工具

• 抓包工具：使用 Wireshark、Fiddler 或浏览器开发者工具查看原始请求和响应。
• 日志拦截器：在 OkHttp/Retrofit 中添加日志拦截器：

  OkHttpClient client = new OkHttpClient.Builder()
      .addInterceptor(new HttpLoggingInterceptor().setLevel(HttpLoggingInterceptor.Level.BODY))
      .build();
  

常见错误原因示例

总结步骤

1. 优先读取响应体：90% 的具体错误信息在此。
2. 检查响应头：寻找自定义错误头。
3. 复现请求：用工具（如 Postman）手动发送相同请求，观察完整响应。
4. 联系后端团队：如果错误信息不明确，可能需要后端补充日志或文档。

通过以上方法，通常可以定位到 400 错误的根本原因。