使用Ktorfit发起带文件的PUT更新请求失败，求解决方案

问题分析 #

你的新增接口可正常运行，但使用PUT请求发送包含文件的multipart数据时，服务器未接收到上传内容，核心问题集中在以下几点：

1. Content-Disposition缺少name参数 #

构建文件请求头时，仅指定了filename，未设置name="photo"字段，服务器无法识别该文件对应的参数名，导致无法解析文件参数。

2. Authorization头重复设置 #

在provideKtorClient中全局设置了Authorization头，同时又在接口方法中手动传递@Header参数，可能导致请求头冲突，影响服务器正常解析。

3. PUT请求的Multipart格式兼容性 #

部分后端框架默认仅支持POST方法处理multipart/form-data类型请求，PUT请求的multipart处理需额外配置。

解决方案 #

1. 修正文件请求头的Content-Disposition #

补充name参数，确保服务器能识别文件对应的参数名：

val multipart = MultiPartFormDataContent(formData {
    append("photo", photoPart.readBytes(), Headers.build {
        append(HttpHeaders.ContentType, "image/png")
        // 补充name参数，与接口定义的参数名一致
        append(HttpHeaders.ContentDisposition, "form-data; name=\"photo\"; filename=\"${photoPart.name}\"")
    })
    append("title", title)
    append("description", description)
    append("price", price)
    append("category_id", category_id)
})

2. 移除重复的Authorization头设置 #

保留一处token传递方式即可，推荐移除HttpClient全局的Authorization配置，避免冲突：

@Provides
@Singleton
fun provideKtorClient(): HttpClient {
    return HttpClient {
        install(ContentNegotiation) {
            json(Json { isLenient = true; ignoreUnknownKeys = true })
        }
        install(Logging) {
            logger = Logger.DEFAULT
            level = LogLevel.ALL
        }
        // 移除全局Authorization头设置，改为在接口方法中手动传递
    }
}

3. 验证服务器对PUT请求的Multipart支持 #

如果上述修改无效，需确认后端是否允许PUT方法接收multipart数据：

• 若后端不支持，可改为用POST方法模拟更新（比如在请求参数中标记更新操作）
• 若后端支持，检查是否需要额外配置解析PUT请求的multipart数据

4. 改用规范的@Multipart注解传递参数（可选） #

使用Ktorfit的@Multipart和@Part注解，更符合multipart请求的规范写法：

interface UpdateApi {
    @Multipart
    @PUT("api/v1/courses/{id}")
    suspend fun updateCourse(
        @Header("Authorization") token: String,
        @Path("id") id: Int,
        @Part("photo") photo: PartFile,
        @Part("title") title: String,
        @Part("description") description: String,
        @Part("price") price: String,
        @Part("category_id") categoryId: Int
    ): String?
}

调用时直接传递参数，无需手动构建MultiPartFormDataContent：

return updateApi.updateCourse(
    "Bearer $token",
    id = id,
    photo = photoPart.asPartFile(),
    title = title,
    description = description,
    price = price,
    categoryId = category_id
)

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