在Android开发中，使用OkHttp发送携带多个参数的POST请求，核心在于正确构造`RequestBody`对象。根据参数类型和数据格式的不同，主要有三种构造方式：使用`FormBody`提交表单键值对、使用`RequestBody`提交JSON等复杂数据、使用`MultipartBody`提交混合数据（如表单和文件）。以下是详细的方案和代码示例。 ### 一、 请求体构造方式对比 | 构造方式 | 适用场景 | 对应MIME类型 | 主要类 | | :--- | :--- | :--- | :--- | | **FormBody** | 提交简单的表单键值对数据，如登录的用户名和密码。 | `application/x-www-form-urlencoded` | `FormBody`, `FormBody.Builder` [ref_2] | | **RequestBody** | 提交JSON、XML、纯文本或二进制数据流等复杂结构数据。 | 如 `application/json` | `RequestBody.create()` 或 `String.toRequestBody()` [ref_3] | | **MultipartBody** | 提交混合数据，通常用于文件上传，可同时包含表单字段和文件部分。 | `multipart/form-data` | `MultipartBody`, `MultipartBody.Part` [ref_2] | ### 二、 具体实现与代码示例 #### 1. 使用 FormBody 提交表单键值对 这是最常见且简单的方式，适合提交多个简单的文本参数。 ```kotlin // Kotlin 示例 import okhttp3.* import java.io.IOException fun postWithFormBody() { val client = OkHttpClient() // 1. 使用 FormBody.Builder 构建表单请求体 val formBody = FormBody.Builder() // [ref_2] .add("username", "testUser") .add("password", "123456") .add("age", "25") .build() // 2. 构建请求 val request = Request.Builder() .url("https://your.api.com/login") .post(formBody) // 将构建好的 FormBody 设置为 POST 请求体 .build() // 3. 发起异步请求 client.newCall(request).enqueue(object : Callback { override fun onFailure(call: Call, e: IOException) { // 处理请求失败 e.printStackTrace() } override fun onResponse(call: Call, response: Response) { // 处理响应 val responseData = response.body?.string() println(responseData) } }) } ``` ```java // Java 示例 import okhttp3.*; public class OkHttpExample { public void postWithFormBody() { OkHttpClient client = new OkHttpClient(); // 1. 构建 FormBody [ref_2] FormBody formBody = new FormBody.Builder() .add("username", "testUser") .add("password", "123456") .add("age", "25") .build(); // 2. 构建请求 Request request = new Request.Builder() .url("https://your.api.com/login") .post(formBody) // [ref_6] .build(); // 3. 发起异步请求 client.newCall(request).enqueue(new Callback() { @Override public void onFailure(Call call, IOException e) { e.printStackTrace(); } @Override public void onResponse(Call call, Response response) throws IOException { String responseData = response.body().string(); System.out.println(responseData); } }); } } ``` #### 2. 使用 RequestBody 提交 JSON 数据 当需要提交结构化的复杂数据（如JSON对象）时，应使用`RequestBody`。这是现代API交互中最常用的方式。 ```kotlin // Kotlin 示例 (OkHttp 4.x 推荐方式) import okhttp3.* import okhttp3.MediaType.Companion.toMediaType fun postJsonWithRequestBody() { val client = OkHttpClient() val jsonMediaType = "application/json; charset=utf-8".toMediaType() // [ref_4] // 1. 构造 JSON 字符串 val json = """ { "username": "testUser", "password": "123456", "profile": { "age": 25, "city": "Beijing" } } """.trimIndent() // 2. 使用字符串的扩展函数创建 RequestBody (OkHttp 4.x 方法) [ref_3] val requestBody = json.toRequestBody(jsonMediaType) // 3. 构建并发送请求 val request = Request.Builder() .url("https://your.api.com/user") .post(requestBody) .build() client.newCall(request).enqueue(object : Callback { override fun onFailure(call: Call, e: IOException) { e.printStackTrace() } override fun onResponse(call: Call, response: Response) { println(response.body?.string()) } }) } ``` ```java // Java 示例 (OkHttp 4.x 推荐方式) import okhttp3.*; import okhttp3.MediaType; public class OkHttpExample { public static final MediaType JSON = MediaType.get("application/json; charset=utf-8"); // [ref_6] public void postJsonWithRequestBody() { OkHttpClient client = new OkHttpClient(); // 1. 构造 JSON 字符串 String json = "{\"username\":\"testUser\",\"password\":\"123456\",\"age\":25}"; // 2. 创建 RequestBody (OkHttp 4.x 推荐方式，替代已过时的 RequestBody.create) [ref_3] RequestBody requestBody = RequestBody.create(json, JSON); // 3. 构建并发送请求 Request request = new Request.Builder() .url("https://your.api.com/user") .post(requestBody) // [ref_5] .build(); client.newCall(request).enqueue(new Callback() { @Override public void onFailure(Call call, IOException e) { e.printStackTrace(); } @Override public void onResponse(Call call, Response response) throws IOException { System.out.println(response.body().string()); } }); } } ``` #### 3. 使用 MultipartBody 提交混合数据（含文件上传） 当POST请求需要同时上传文件和文本参数时，必须使用`MultipartBody`。 ```kotlin // Kotlin 示例 import okhttp3.* import okhttp3.MediaType.Companion.toMediaType import okhttp3.RequestBody.Companion.asRequestBody import okhttp3.RequestBody.Companion.toRequestBody import java.io.File fun uploadFileWithMultipartBody() { val client = OkHttpClient() // 1. 准备文件 val file = File("/sdcard/avatar.jpg") val fileRequestBody = file.asRequestBody("image/jpeg".toMediaType()) // [ref_2] // 2. 构建 MultipartBody val requestBody = MultipartBody.Builder() .setType(MultipartBody.FORM) .addFormDataPart("username", "testUser") // 文本参数 .addFormDataPart("description", "My profile photo") .addFormDataPart( // 文件参数 "avatar", file.name, fileRequestBody ) .build() // 3. 构建并发送请求 val request = Request.Builder() .url("https://your.api.com/upload") .post(requestBody) .build() client.newCall(request).enqueue(object : Callback { override fun onFailure(call: Call, e: IOException) { e.printStackTrace() } override fun onResponse(call: Call, response: Response) { println(response.body?.string()) } }) } ``` ### 三、 关键注意事项与最佳实践 1. **权限与依赖**：确保在 `AndroidManifest.xml` 中添加网络权限 `<uses-permission android:name="android.permission.INTERNET" />` [ref_1]，并在 `build.gradle` 中引入最新版本的OkHttp依赖，例如 `implementation 'com.squareup.okhttp3:okhttp:4.11.0'`。 2. **主线程限制**：网络请求必须在子线程中执行。OkHttp的 `enqueue` 方法自动在后台线程执行回调，但**回调方法本身也在后台线程**。如果需要更新UI，必须使用 `runOnUiThread`、`Handler` 或 `LiveData` 将结果切换到主线程 [ref_5]。 3. **媒体类型（MediaType）**：使用 `RequestBody` 时，务必正确设置 `MediaType`（如 `application/json`），这关系到服务器能否正确解析请求体 [ref_2][ref_6]。 4. **参数编码**：`FormBody` 会自动对参数进行URL编码。如果手动构建JSON字符串，需注意特殊字符的转义。 5. **复杂JSON处理**：对于复杂的嵌套对象，建议使用 `Gson` 或 `Moshi` 等库将对象序列化为JSON字符串，再构建 `RequestBody`。接收服务器返回的JSON数组时，也可以使用 `Gson` 配合 `JSONArray` 进行反序列化 [ref_1]。 通过上述三种方式，你可以根据具体的业务场景（简单表单、复杂JSON、文件上传）灵活选择并正确构造 `RequestBody` 对象，从而高效、可靠地完成Android端的网络通信任务。