Android Studio中POST API调用如何传递图片参数？

你当前的getParams()方法只能处理字符串类型的表单参数，而传递图片（二进制文件）需要使用multipart/form-data格式提交请求，以下是两种主流实现方案：

方案一：使用OkHttp原生实现 #

OkHttp是Android中常用的网络库，直接构建Multipart请求体即可实现文件上传：

// 初始化OkHttp客户端
val okHttpClient = OkHttpClient()

// 替换为你的本地图片文件路径
val imageFile = File("/storage/emulated/0/DCIM/Camera/photo.jpg")

// 构建Multipart请求体，包含文本参数和图片
val multipartBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    // 添加原有的documents文本参数，替换为实际需要的内容
    .addFormDataPart("documents", "这里是documents参数的内容")
    // 添加图片参数：第一个参数是接口要求的参数名，第二个是文件名，第三个是文件体
    .addFormDataPart(
        "image", // 替换为接口要求的图片参数名
        imageFile.name,
        RequestBody.create(MediaType.parse("image/jpeg"), imageFile)
    )
    .build()

// 构建请求
val request = Request.Builder()
    .url("你的API接口完整地址")
    .post(multipartBody)
    .build()

// 异步发送请求
okHttpClient.newCall(request).enqueue(object : Callback {
    override fun onFailure(call: Call, e: IOException) {
        // 请求失败的处理逻辑
    }

    override fun onResponse(call: Call, response: Response) {
        // 请求成功的处理逻辑，可通过response.body()获取返回内容
    }
})

方案二：使用Retrofit实现 #

如果项目中使用Retrofit，通过@Multipart注解定义接口即可：

1. 定义Retrofit接口 #

interface UploadApi {
    @Multipart
    @POST("你的接口相对路径")
    fun uploadData(
        // 文本参数
        @Part("documents") documents: RequestBody,
        // 图片参数
        @Part image: MultipartBody.Part
    ): Call<YourResponseModel> // 替换为你的实际响应数据模型
}

2. 发起上传请求 #

// 初始化Retrofit
val retrofit = Retrofit.Builder()
    .baseUrl("你的API基础地址")
    .addConverterFactory(GsonConverterFactory.create())
    .build()

val uploadApi = retrofit.create(UploadApi::class.java)

// 准备图片文件
val imageFile = File("/storage/emulated/0/DCIM/Camera/photo.jpg")
val imageRequestBody = RequestBody.create(MediaType.parse("image/jpeg"), imageFile)
val imagePart = MultipartBody.Part.createFormData(
    "image", // 接口要求的图片参数名
    imageFile.name,
    imageRequestBody
)

// 准备文本参数
val documentsRequestBody = RequestBody.create(MediaType.parse("text/plain"), "documents参数内容")

// 发起请求
uploadApi.uploadData(documentsRequestBody, imagePart).enqueue(object : Callback<YourResponseModel> {
    override fun onResponse(call: Call<YourResponseModel>, response: Response<YourResponseModel>) {
        // 请求成功处理
    }

    override fun onFailure(call: Call<YourResponseModel>, t: Throwable) {
        // 请求失败处理
    }
})

关键注意点 #

• 确认接口要求的图片参数名（示例中的image）必须与后端定义一致
• 图片的MediaType要匹配文件类型：jpg用image/jpeg，png用image/png
• Android 6.0及以上需要动态申请文件读取权限（Android 13+需申请READ_MEDIA_IMAGES权限）
• 如果使用Volley框架，可以自定义MultipartRequest类实现相同逻辑，核心是构建包含文件的multipart请求体

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