如何使用Ktor上传单张bitmap图像？现有实现上传失败问题排查

问题根源 #

你这个写法的核心错误是：submitFormWithBinaryData 方法本身就是用来构建 multipart/form-data 格式的文件上传请求体的，你在block参数里手动设置了contentType(ContentType.Application.Json) 并且赋值了body = jsonBody.toString()，直接把Ktor自动生成的multipart表单请求体完全覆盖了，所以服务端只能收到JSON数据，收不到上传的文件。

修正方案 #

1. 首先删除block回调里的两行代码：contentType(ContentType.Application.Json)和body = jsonBody.toString()。submitFormWithBinaryData会自动生成带边界（boundary）标识的正确Content-Type头，不需要你手动指定，手动指定反而会丢失边界信息，导致服务端无法解析表单内容。
2. 如果你需要传递额外的JSON参数，根据服务端要求二选一即可：
   • 如果服务端支持普通表单字段传参，把JSON里的所有字段拆成单独的表单项，逐个用append方法添加到formData中。
   • 如果服务端要求整段接收JSON结构，在formData里新增一个专门的表单项存储JSON字符串，单独指定其Content-Type为application/json。
3. 两个兼容性优化细节：
   • 文件对应的Content-Disposition头补全标准格式：form-data; name="字段名"; filename="文件名"，避免部分校验严格的服务端直接忽略文件。
   • JPG格式的标准MIME类型是image/jpeg，部分服务端不识别image/jpg的写法，建议统一替换。

正确代码示例 #

// srcBitmap 是包含JPG数据的ByteArray
val response: HttpResponse = httpClient.submitFormWithBinaryData(
    url = URLUploadFile,
    formData = formData {
        // 方式1：拆分JSON参数为单独表单项
        append("user_id", "123")
        append("description", "测试上传")
        
        // 方式2：整段传JSON，不需要的话可以删掉这部分
        append("json_params", jsonBody.toString(), Headers.build {
            append(HttpHeaders.ContentType, ContentType.Application.Json.toString())
        })
        
        append("bitmapName", "image.jpg")
        append("image", srcBitmap, Headers.build {
            append(HttpHeaders.ContentType, "image/jpeg")
            append(HttpHeaders.ContentDisposition, "form-data; name=\"image\"; filename=\"image.jpg\"")
        })
    },
    block = {
        headers {
            append(HttpHeaders.CacheControl, "no-cache")
            append("my-app-authtoken", PREFKEY_AUTHTOKEN)
            append("my-app-id", PREFKEY_USERID)
        }
        // 不要在这里手动设置contentType和body
    })

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