Retrofit 2 Multipart仅传图片未传全部数据问题求助

嘿，我来帮你排查下 Retrofit 2 用 Multipart 上传图片时数据不全的问题～

1. 核对服务接口的注解配置 #

首先得确保你的接口方法标注完全正确，举个示例（Kotlin/Java 逻辑一致）：

@Multipart
@POST("upload/image")
suspend fun uploadImage(
    @Part image: MultipartBody.Part,
    @Part("description") desc: RequestBody // 如有其他参数也需按规则标注
): Response<UploadResult>

这里要注意两个关键：

• 必须加上@Multipart注解，否则 Retrofit 不会按多部分表单格式处理请求
• 图片参数必须用@Part搭配MultipartBody.Part类型，不能直接传 File 或普通 RequestBody（除非你手动构建了完整的 MultipartBody）

2. 检查图片 Part 的构建逻辑（getImage() 函数） #

你的getImage()负责生成上传用的图片 Part，这里很容易踩坑，正确的构建方式参考：

fun getImage(file: File): MultipartBody.Part {
    // 匹配实际图片的 MediaType，比如 png 就用 "image/png"
    val requestFile = RequestBody.create(MediaType.parse("image/jpeg"), file)
    // 第一个参数是API要求的表单字段名，必须和后端定义完全一致
    return MultipartBody.Part.createFormData("image", file.name, requestFile)
}

要排查的细节：

• 确认文件存在且可读：可以加判断if (!file.exists() || !file.canRead())，避免传入空文件或无权限读取的文件
• MediaType 要和图片实际类型匹配，不确定的话可以用image/*，但精准匹配更稳妥
• createFormData的第一个参数（表单字段名）必须和后端接口要求的完全一致，比如后端要upload_file就不能写image

3. 开启日志拦截器，查看真实请求内容 #

很多时候后端说没收到数据，是因为请求本身就有问题。你可以给 OkHttp 加日志拦截器，查看完整的请求体：

val loggingInterceptor = HttpLoggingInterceptor().apply {
    level = HttpLoggingInterceptor.Level.BODY // 必须设为BODY才能看到Multipart的详细内容
}
val okHttpClient = OkHttpClient.Builder()
    .addInterceptor(loggingInterceptor)
    .build()
val retrofit = Retrofit.Builder()
    .baseUrl("你的API地址")
    .client(okHttpClient)
    .addConverterFactory(GsonConverterFactory.create())
    .build()

查看日志时重点关注：

• 图片的 Content-Length 是否和文件实际大小一致，不一致说明文件读取有问题
• 请求体是否有截断情况，如果日志里的 Multipart 内容突然中断，可能是超时配置太短

4. 调整超时时间配置 #

如果图片体积较大，默认的超时时间可能导致上传中途中断，建议延长写超时时间：

val okHttpClient = OkHttpClient.Builder()
    .connectTimeout(30, TimeUnit.SECONDS)
    .readTimeout(60, TimeUnit.SECONDS)
    .writeTimeout(60, TimeUnit.SECONDS) // 上传主要依赖这个写超时，可根据图片大小调整
    .addInterceptor(loggingInterceptor)
    .build()

5. 排查后端接收配置 #

如果以上步骤都没问题，那可能是后端的问题：

• 确认后端是否限制了上传文件的大小
• 检查是否有防火墙、反向代理等中间件截断了大请求

你可以按照上面的步骤逐一排查，尤其是日志拦截器那一步，能帮你快速定位问题所在～

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