Android Studio中POST调用REST API如何同时传form-data请求体与参数

完全可以实现，不存在技术限制。HTTP协议中，URL携带的查询参数（即你说的Params）和POST请求体是相互独立的两个组成部分，不会因为请求体使用multipart/form-data格式就无法携带URL参数，服务端可以分别从URL查询串、form-data请求体中解析到对应参数。

以下是Android生态下最常用的两种网络栈的实现代码：

方案1：OkHttp 原生实现 #

// 1. 构造带查询参数的URL，自动处理URL编码
val requestUrl = HttpUrl.Builder()
    .scheme("https")
    .host("你的接口域名")
    .addPathSegment("接口路径")
    // 逐个添加URL Params参数
    .addQueryParameter("param_key1", "参数值1")
    .addQueryParameter("param_key2", "参数值2")
    .build()

// 2. 构造form-data格式请求体
val formBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    // 添加普通表单字段
    .addFormDataPart("form_key1", "表单字段值1")
    .addFormDataPart("form_key2", "表单字段值2")
    // 若需要上传文件可按如下格式添加
    // .addFormDataPart("file_field", "本地文件名", 文件对应的RequestBody)
    .build()

// 3. 组装POST请求
val request = Request.Builder()
    .url(requestUrl)
    .post(formBody)
    .build()

// 用自己初始化的OkHttpClient实例发起请求即可
okHttpClient.newCall(request).enqueue(/* 自己实现请求回调 */)

方案2：Retrofit 声明式实现（Android开发主流方案） #

Retrofit原生支持同时声明URL查询参数和Multipart请求体，不需要额外适配。
首先定义接口：

interface ApiService {
    @Multipart
    @POST("接口路径")
    suspend fun postFormWithParams(
        // 标注为@Query的参数会自动拼接到URL作为Params
        @Query("param_key1") param1: String,
        @Query("param_key2") param2: String,
        // 标注为@Part的参数会放入form-data请求体
        @Part("form_key1") formValue1: RequestBody,
        @Part("form_key2") formValue2: RequestBody,
        // 传文件可按如下格式声明
        // @Part file: MultipartBody.Part
    ): Response<你的返回数据类>
}

发起请求的代码示例：

// 构造form-data普通字段的RequestBody
val formVal1 = "表单字段值1".toRequestBody(MultipartBody.FORM)
val formVal2 = "表单字段值2".toRequestBody(MultipartBody.FORM)

// 调用接口时同时传入Params和表单参数即可
apiService.postFormWithParams(
    param1 = "参数值1",
    param2 = "参数值2",
    formValue1 = formVal1,
    formValue2 = formVal2
)

• 严格按照接口文档区分参数位置：如果接口要求参数是URL Params，就不要放到form-data表单项里，反之亦然，避免服务端解析失败
• 不要手动拼接URL查询串，优先使用框架提供的参数添加方法，框架会自动完成URL编码，避免中文、空格、特殊符号导致的参数错乱
• 调试阶段可通过抓包验证请求结构：最终发出的请求URL后会携带Params参数，请求体为标准form-data格式，二者完全独立互不干扰

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