Android中使用Retrofit 2.0将图片嵌入嵌套JSON请求体上传

我明白你现在的困扰——习惯了用@Multipart传图，但这次要把图片塞进嵌套JSON结构里，确实有点绕。其实核心问题是：JSON本身没法直接存储二进制文件，所以我们得借助multipart/form-data的特性，把嵌套结构拆成带层级的表单字段，同时把图片作为单独的Part传递。下面给你两种可行的方案：

方案一：用层级化表单键映射嵌套结构 #

大多数后端框架（比如Spring、Rails）都支持通过带方括号的键名来自动解析嵌套对象，我们可以利用这一点来模拟你需要的JSON结构：

1. 定义Retrofit接口 #

interface UserProfileApi {
    @Multipart
    @POST("profile/upload") // 替换成你的实际接口地址
    suspend fun uploadProfileImage(
        @Part("user[profile][id]") idRequestBody: RequestBody,
        @Part imagePart: MultipartBody.Part
    ): Response<UploadResponse> // 替换成你的响应模型
}

2. 构建请求参数并调用接口 #

// 1. 处理ID参数
val userId = "1001" // 替换成实际的ID值
val idRequestBody = userId.toRequestBody("text/plain".toMediaTypeOrNull())

// 2. 处理图片文件
val imageFile = File("/sdcard/DCIM/profile.jpg") // 替换成你的图片路径
val imageRequestBody = imageFile.asRequestBody("image/jpeg".toMediaTypeOrNull())
// 这里的键名"user[profile][image][photo]"对应嵌套结构里的位置
val imagePart = MultipartBody.Part.createFormData(
    "user[profile][image][photo]",
    imageFile.name,
    imageRequestBody
)

// 3. 调用接口（假设你已经初始化了Retrofit实例）
val apiService = retrofit.create(UserProfileApi::class.java)
val response = apiService.uploadProfileImage(idRequestBody, imagePart)

方案二：单独传递JSON结构+图片Part #

如果后端要求必须有一个完整的JSON字段承载嵌套结构（除了图片），可以把JSON部分作为一个单独的RequestBody，再搭配图片Part：

1. 定义Retrofit接口 #

interface UserProfileApi {
    @Multipart
    @POST("profile/upload")
    suspend fun uploadProfileImage(
        @Part("user[profile]") profileJson: RequestBody,
        @Part("user[profile][image][photo]") imagePart: MultipartBody.Part
    ): Response<UploadResponse>
}

2. 构建请求参数 #

// 1. 构造嵌套JSON字符串（不含图片字段）
val profileJsonStr = """
    {
        "id": "1001"
    }
""".trimIndent()
val profileRequestBody = profileJsonStr.toRequestBody("application/json".toMediaTypeOrNull())

// 2. 构建图片Part（和方案一一致）
val imageFile = File("/sdcard/DCIM/profile.jpg")
val imageRequestBody = imageFile.asRequestBody("image/jpeg".toMediaTypeOrNull())
val imagePart = MultipartBody.Part.createFormData(
    "user[profile][image][photo]",
    imageFile.name,
    imageRequestBody
)

// 3. 调用接口
val apiService = retrofit.create(UserProfileApi::class.java)
val response = apiService.uploadProfileImage(profileRequestBody, imagePart)

关键说明 #

• 为什么不能直接用@Body传嵌套JSON？因为JSON是文本格式，无法携带二进制图片数据，必须用multipart/form-data来同时传递文本参数和文件。
• 两种方案的核心都是用层级化的表单键名，让后端能解析出你需要的{ "user": { "profile": { "id": id, "image": { "photo": photo } } } }结构。

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