使用Ktor客户端向Ktor服务器上传文件失败问题求助

首先，你的问题大概率是由服务器端缺少Multipart支持插件和客户端请求头格式错误共同导致的，而非Ktor客户端的Bug。下面逐步拆解并给出修复方案：

1. 服务器端核心问题：未安装Multipart处理插件 #

Ktor服务器要接收multipart/form-data请求，必须先安装Multipart插件并添加对应的依赖。从你的Gradle配置来看，服务器端没有引入ktor-server-multipart依赖，也没有安装该插件，这会导致服务器无法识别multipart请求，进而抛出"Content-Type header is required for multipart processing"的错误。

修复步骤： #

• 添加Gradle依赖：在服务器端的build.gradle中加入：

  implementation("io.ktor:ktor-server-multipart:${ktor_version}")
  

• 安装Multipart插件：在你的Application初始化代码中安装插件：

  fun Application.module() {
      install(Multipart) {
          // 可选配置：设置最大允许上传的文件大小，比如100MB
          maxFileSize = 100_000_000
      }
      // 其他配置...
      routing {
          images(ImagesModule())
      }
  }
  

2. 客户端问题：Content-Disposition头格式错误 #

你手动构建的Content-Disposition头格式不符合HTTP规范，正确的格式需要同时包含表单字段名（name）和文件名（filename），且需要用form-data;前缀。错误的头格式会导致Ktor客户端无法正确生成完整的multipart/form-data请求头，这也是服务器端接收不到Content-Type的原因之一。

另外，不要手动设置请求的Content-Type——submitFormWithBinaryData会自动为multipart请求生成带boundary的Content-Type头，手动设置会触发引擎报错（"Header Content-Type is controlled by the engine..."）。

修复后的客户端代码： #

推荐使用Ktor提供的简化API来构建表单数据，它会自动处理正确的请求头：

val parts: List<PartData> = formData { 
    // 直接使用带文件名和ContentType的append重载
    append(
        key = "image",
        value = InputProvider { ins.asInput() },
        name = name, // 这里的name是上传文件的文件名
        contentType = ContentType.Image.PNG
    ) 
} 

return HttpClient(Apache) { 
    install(Logging) { 
        logger = Logger.DEFAULT 
        level = LogLevel.ALL 
    } 
}.submitFormWithBinaryData(formData = parts) { 
    url("$baseUrl/images") 
}

如果需要手动构建Headers，也要保证格式正确：

val parts: List<PartData> = formData { 
    append( "image", InputProvider { ins.asInput() }, 
        Headers.build { 
            this[HttpHeaders.ContentType] = ContentType.Image.PNG.toString() 
            // 使用Ktor的ContentDisposition类生成规范的头内容
            this[HttpHeaders.ContentDisposition] = ContentDisposition.File(
                name = "image", // 表单字段名，对应服务器端接收的key
                filename = name // 上传的文件名
            ).toString() 
        } 
    ) 
}

为什么OkHttp客户端可以成功？ #

OkHttp客户端会自动修正或补充不规范的请求头格式，同时服务器端即使缺少Multipart插件，OkHttp可能发送的请求格式让服务器临时识别到了，但这不是正确的解决方案——安装Multipart插件才是Ktor服务器处理文件上传的标准方式。

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