<think>我们正在讨论OKHTTP中使用application/x-www-form-urlencoded编码格式的POST请求。 根据引用[1]和[3]，我们知道application/x-www-form-urlencoded是常见的编码格式，用于键值对参数，参数之间用&间隔。 同时引用[3]指出，在使用OkHttp时，需要正确设置媒体类型（MediaType）和字符编码（如UTF-8）。 步骤： 1. 构建请求体（RequestBody），需要指定MediaType为"application/x-www-form-urlencoded"，并注意设置字符编码（通常为UTF-8）。 2. 将参数按照键值对的形式进行编码，格式为key1=value1&key2=value2，其中键和值都需要进行URL编码（使用URLEncoder.encode()）。 3. 创建请求体对象，通常使用FormBody（是RequestBody的一个子类，专门用于application/x-www-form-urlencoded）来构建，它会自动处理URL编码。 另外，引用[2]中给出了使用HttpClient的示例，我们可以参考其思想，但在OkHttp中实现。 OkHttp使用FormBody的示例： FormBody formBody = new FormBody.Builder() .add("key1", "value1") .add("key2", "value2") .build(); 然后构建请求： Request request = new Request.Builder() .url(url) .post(formBody) .build(); 最后通过OkHttpClient发送请求。 注意：FormBody在添加参数时已经自动对键和值进行了URL编码（默认UTF-8）。所以不需要手动编码。 但如果我们使用MediaType.parse("application/x-www-form-urlencoded")来手动构建RequestBody，则需要自己进行编码（不推荐，FormBody更方便）。 参考引用[3]，如果出现不支持的媒体类型错误（Content type not supported），可能是因为没有正确设置charset，但FormBody已经处理了这个问题。 示例代码： </think> ### OKHTTP 使用 `x-www-form-urlencoded` 的方法与示例 `application/x-www-form-urlencoded` 是 HTTP POST 请求的默认编码格式，适用于键值对参数（如表单数据）。在 OkHttp 中实现步骤如下： #### 一、核心步骤 1. **创建 `FormBody` 对象** 通过 `FormBody.Builder()` 构建键值对参数： ```kotlin val formBody = FormBody.Builder() .add("firstName", "张") // 自动进行 URL 编码 .add("lastName", "三") .build() ``` *说明*：键值对会被自动编码为 `firstName=%E5%BC%A0&lastName=%E4%B8%89` 格式[^1]。 2. **构建 POST 请求** 将 `FormBody` 作为请求体发送： ```kotlin val request = Request.Builder() .url("https://api.example.com/task") .post(formBody) // 关键：设置编码格式 .build() ``` 3. **发送请求并处理响应** ```kotlin val response = OkHttpClient().newCall(request).execute() if (response.isSuccessful) { println(response.body?.string()) // 输出：张三 } ``` --- #### 二、完整示例代码 (Kotlin) ```kotlin import okhttp3.* fun postFormData() { val client = OkHttpClient() // 1. 构建表单数据 val formBody = FormBody.Builder() .add("firstName", "张") .add("lastName", "三") .build() // 2. 创建请求 val request = Request.Builder() .url("https://api.example.com/task") .post(formBody) .build() // 3. 发送请求 client.newCall(request).execute().use { response -> if (response.isSuccessful) { println("响应结果: ${response.body?.string()}") } else { println("请求失败: ${response.code}") } } } ``` --- #### 三、关键注意点 1. **编码格式** `FormBody` **自动使用 UTF-8 编码**参数值，无需手动处理特殊字符（如中文）[^2]。 *错误示例*：未指定编码会导致服务器返回 `415 Unsupported Media Type`[^3]。 2. **Header 设置** OkHttp 默认添加 `Content-Type: application/x-www-form-urlencoded`，**无需额外设置**。 3. **参数限制** - 适用于简单文本数据（非文件上传） - 数据大小限制通常为 **2MB**（不同服务器有差异） --- #### 四、与传统表单对比 | 操作 | HTML 表单 | OkHttp 等效代码 | |------------------|---------------------------|-------------------------------| | 设置编码类型 | `<form enctype="...">` | 自动由 `FormBody` 处理 | | 添加参数 | `<input name="key">` | `.add("key", "value")` | | 发送 | 浏览器自动提交 | `.post(formBody)` | ---