使用OkHttp通过PUT请求上传图片报400错误请求，求助排查

嘿，我懂你现在的头疼事儿：Postman里能正常运行的PUT图片上传请求，换到Android用OkHttp实现就返回400错误，而且你已经参考过相关方案还是没解决。咱们一步步来排查可能的问题：

1. 核对请求体的构建细节 #

服务器对请求体的格式、字段名往往很敏感，先确认这部分和Postman完全一致：

• 首先检查Multipart的API是否正确：如果你的OkHttp版本是3.x及以上，旧的MultipartBuilder已经被MultipartBody.Builder替代，正确的构建方式应该是这样：

  RequestBody requestBody = new MultipartBody.Builder()
      .setType(MultipartBody.FORM)
      // 这里的第一个参数"file"要和Postman里的表单字段名*完全一致*，包括大小写
      .addFormDataPart("file", file.getName(),
          RequestBody.create(MediaType.parse("image/jpeg"), file))
      .build();
  

• 务必确保addFormDataPart的字段名、文件名、MIME类型和Postman中设置的完全相同，比如服务器要求字段名是upload_file而不是file，就会直接返回400。

2. 确认请求方法和URL的正确性 #

• 一定要明确使用PUT方法，代码里别写成POST：

  Request request = new Request.Builder()
      .url(serverURL)
      .put(requestBody) // 这里必须是put，和Postman的请求方法一致
      .build();
  

• 检查URL是否存在编码问题：比如URL里包含空格、中文等特殊字符，Postman会自动编码，但Android中可能需要你确保URL是正确编码后的，或者用OkHttp的HttpUrl来构建URL避免错误。

3. 匹配Postman的请求头 #

很多服务器会校验请求头，遗漏或不匹配都会导致400：

• 把Postman里的所有请求头（比如Authorization、User-Agent、Accept等）都同步到代码中，比如如果需要身份令牌：

  Request request = new Request.Builder()
      .url(serverURL)
      .addHeader("Authorization", "Bearer " + yourToken)
      .addHeader("User-Agent", "Android-App/1.0")
      .put(requestBody)
      .build();
  

• 注意：使用MultipartBody时，不要手动设置Content-Type头，OkHttp会自动生成带正确边界的multipart/form-data头，手动设置反而会导致格式错误。

4. 查看服务器返回的具体错误信息 #

400错误通常会附带详细的错误描述，这是最直接的排查线索：

• 在代码中打印响应的错误内容：

  Response response = client.newCall(request).execute();
  if (!response.isSuccessful()) {
      if (response.body() != null) {
          String errorMsg = response.body().string();
          Log.e("UploadError", "服务器错误信息：" + errorMsg);
      }
      return false;
  }
  

• 比如服务器可能返回“缺少必填字段”“文件类型不允许”等信息，能直接定位问题。

5. 检查文件的可用性 #

• 确保你传入的File对象存在且可读，Android中还要注意权限问题：

  if (!file.exists() || !file.canRead()) {
      Log.e("UploadError", "文件不存在或无法读取");
      return false;
  }
  

• 如果是Android 10及以上，还要注意存储权限的适配，避免因为权限不足导致读取文件失败，上传空内容给服务器。

6. 升级OkHttp版本 #

旧版本的OkHttp可能存在一些兼容性bug，建议升级到最新稳定版，比如在你的build.gradle（Module级）中：

implementation 'com.squareup.okhttp3:okhttp:4.12.0'

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