Ktor发送Multipart请求报错：找不到MultipartBody序列化器怎么办？

你遇到的“Serializer for class 'MultipartBody' is not found”错误，根源在于两个核心问题：

• 你使用了OkHttp的MultipartBody类，但Ktor客户端有独立的Multipart处理体系，默认序列化器无法识别OkHttp的这个类
• 错误设置了Content-Type: application/json请求头，和Multipart表单的类型完全冲突

修复步骤及代码示例 #

1. 确保引入Ktor Multipart依赖
   如果使用Gradle，在build.gradle.kts中添加对应依赖（替换$ktorVersion为你使用的Ktor版本）：

   implementation("io.ktor:ktor-client-multipart:$ktorVersion")
   

2. 改用Ktor原生Multipart API构建请求体
   替换OkHttp的MultipartBody为Ktor的MultiPartFormDataContent，通过formDataDSL构建表单内容：

import io.ktor.client.request.forms.MultiPartFormDataContent
import io.ktor.client.request.forms.formData
import io.ktor.http.ContentType
import io.ktor.http.content.fileProvider
import java.io.File

// 构建Ktor兼容的Multipart表单
val multipartBody = MultiPartFormDataContent(formData {
    // 添加普通文本字段
    append("choice", "John Wick")
    // 添加文件字段，自动处理文件内容和类型
    append(
        key = "image",
        filename = path.substringAfterLast("/"), // 提取文件名称
        contentType = ContentType.Application.OctetStream,
        content = fileProvider(File(path))
    )
})

// 发送请求
val httpResponse = client.post {
    url("https://example.com")
    setBody(multipartBody)
    header("Authorization", "Bearer key")
    // 无需手动设置Content-Type，Ktor会自动添加正确的multipart/form-data及边界标识
}

关键说明 #

• Ktor的MultiPartFormDataContent会自动生成符合规范的Content-Type请求头，包含multipart/form-data类型和随机边界字符串，完全不需要手动配置
• 使用formDataDSL可以更简洁地管理表单字段，普通文本字段直接用append(key, value)，文件字段只需指定文件名、内容类型和文件来源即可

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