使用Retrofit上传图片至服务器失败，Postman可正常上传的问题咨询

嘿，我之前也踩过一模一样的坑！Postman能正常上传但Retrofit不行，基本不是图片格式的问题——毕竟Postman能处理的格式，Retrofit肯定也能传。问题十有八九出在你的Retrofit请求构造和Postman的请求不一致上，咱们一步步排查：

1. 先和Postman的请求做对比 #

先打开Postman的「Code」功能（右上角的</>图标），看看它生成的请求结构，重点关注这几个点：

• 是不是用了multipart/form-data格式？
• 图片对应的form-data参数名是什么（比如是file、image还是别的）？
• 有没有额外的请求头（比如Token、Content-Disposition）？
• 图片的MIME类型是不是正确识别（比如image/jpeg、image/png）？

你的Retrofit请求必须和这些完全一致，差一点都可能导致服务器无法识别。

2. 正确的Retrofit上传示例 #

假设Postman里是把图片放在form-data的file参数下，那你的代码应该这么写：

第一步：定义Retrofit接口 #

public interface UploadService {
    @Multipart
    @POST("你的上传接口路径")
    Call<ResponseBody> uploadImage(
        @Part MultipartBody.Part imageFile,
        @Part("如果有其他文本参数就加在这里") RequestBody extraParam // 可选
    );
}

第二步：构造请求体并调用 #

// 从FileUtils拿到的图片文件
File image = ...;

// 重点：获取正确的MIME类型，别硬写死！
String mimeType = FileUtils.getMimeType(getContext(), Uri.fromFile(image));
RequestBody requestFile = RequestBody.create(MediaType.parse(mimeType), image);

// 构造MultipartPart，参数名要和Postman里的完全一致！
MultipartBody.Part imagePart = MultipartBody.Part.createFormData(
    "file", // 这里的key必须和Postman里的form-data参数名一样
    image.getName(),
    requestFile
);

// 如果有额外的文本参数
RequestBody extraParam = RequestBody.create(MediaType.parse("text/plain"), "这是图片描述");

// 发起请求
Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("你的服务器基础地址")
    .addConverterFactory(GsonConverterFactory.create())
    .build();

UploadService service = retrofit.create(UploadService.class);
Call<ResponseBody> call = service.uploadImage(imagePart, extraParam);
call.enqueue(new Callback<ResponseBody>() {
    @Override
    public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
        // 处理成功回调
    }

    @Override
    public void onFailure(Call<ResponseBody> call, Throwable t) {
        // 处理失败回调
    }
});

3. 最容易踩的几个坑 #

• MIME类型错误：别直接用image/*或者application/octet-stream，服务器可能不识别。用FileUtils.getMimeType()获取真实的图片类型更稳妥。
• 参数名不匹配：Postman里是image你写成file，服务器自然找不到图片文件，必须完全一致。
• 权限或文件路径问题：Android 10+用Scoped Storage，直接获取的File路径可能没有读取权限。这种情况下可以通过ContentResolver获取输入流来构造RequestBody：

  InputStream inputStream = getContentResolver().openInputStream(imageUri);
  byte[] imageBytes = convertInputStreamToByteArray(inputStream); // 自己实现流转字节数组
  RequestBody requestFile = RequestBody.create(MediaType.parse(getContentResolver().getType(imageUri)), imageBytes);
  

• 没加日志拦截器：不知道请求到底发了什么？加个OkHttp日志拦截器，直接在Logcat里看完整请求，和Postman对比：

  OkHttpClient client = new OkHttpClient.Builder()
      .addInterceptor(new HttpLoggingInterceptor().setLevel(HttpLoggingInterceptor.Level.BODY))
      .build();
  
  Retrofit retrofit = new Retrofit.Builder()
      .baseUrl("你的基础地址")
      .client(client)
      .addConverterFactory(GsonConverterFactory.create())
      .build();
  

最后总结 #

先抓包对比Postman和Retrofit的请求内容，找差异点——这是最快定位问题的方法。只要请求结构和Postman完全一致，服务器肯定能处理你的图片，不用特意转换格式~

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