OkHttp3中Request.Builder的post方法无法接收FormBody参数问题

核心原因 #

这种类型不匹配问题几乎都是依赖版本不一致或类导入错误导致的——FormBody确实继承自RequestBody，但如果两者来自不同的OkHttp版本或类加载上下文，JVM会判定它们是完全不同的类型。

解决步骤 #

1. 统一OkHttp依赖版本 #

确保所有OkHttp相关依赖使用同一版本（4.12.0），避免混合版本造成类冲突。修改Module级别的build.gradle（或build.gradle.kts）：

// Groovy语法
implementation 'com.squareup.okhttp3:okhttp:4.12.0'
// 如果用到日志拦截器等子模块，版本必须一致
implementation 'com.squareup.okhttp3:logging-interceptor:4.12.0'

// Kotlin DSL语法
implementation("com.squareup.okhttp3:okhttp:4.12.0")
implementation("com.squareup.okhttp3:logging-interceptor:4.12.0")

2. 确认类导入正确性 #

检查代码中的导入语句，确保FormBody和RequestBody都来自okhttp3包：

import okhttp3.FormBody
import okhttp3.Request
import okhttp3.RequestBody

避免导入其他包（比如旧版OkHttp或第三方封装类），这会直接导致类型不兼容。

3. 清理缓存并重构项目 #

Android Studio的缓存可能导致类识别异常，执行以下操作：

• 点击 File -> Invalidate Caches...，选择Invalidate and Restart重启IDE
• 同步Gradle（点击右上角的Sync Project with Gradle Files按钮）
• 执行 Build -> Rebuild Project 重新构建

正确的表单提交代码 #

依赖和导入都修复后，官方示例代码可正常运行，完整示例：

import okhttp3.FormBody
import okhttp3.OkHttpClient
import okhttp3.Request
import java.io.IOException

fun main() {
    val client = OkHttpClient()

    val formBody = FormBody.Builder()
        .add("search", "Jurassic Park")
        .build()

    val request = Request.Builder()
        .url("https://en.wikipedia.org/w/index.php")
        .post(formBody)
        .build()

    client.newCall(request).execute().use { response ->
        if (!response.isSuccessful) throw IOException("Unexpected code: $response")
        println(response.body?.string())
    }
}

关于强制转换的说明 #

强制转换FormBody为RequestBody出现“转换永远无法成功”的警告，本质是两个类来自不同的类路径，JVM不认为它们存在继承关系，这种转换完全无效，必须从依赖和导入层面解决问题，而非强制转换。

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