Ktor上传文件用append()还是buildPacket()？二者区别及适用场景

这两种都是Ktor构造multipart/form-data请求的写法，核心差异在数据加载和写入的逻辑上：

核心区别 #

• 你使用的append("image", srcBitmap, headers)是Ktor封装的便捷重载：你直接把已经完整加载到内存里的ByteArray传入，Ktor内部自动帮你把这个字节数组封装成表单块写入请求，不需要手动处理写入逻辑。
• 另一种写法的appendInput是底层流式API：它通过lambda暴露写入管道，你可以在lambda里按需写入字节，不需要提前把所有二进制数据全部加载到内存里。示例里直接一次性写入icon.toByteArray()只是最简写法，没有用到它的流式特性。

各自适用场景 #

• append直接传ByteArray的适用场景：
  • 上传的文件体积小，比如几KB到几十MB的头像、截图、缩略图
  • 业务逻辑已经提前生成了完整的字节数组，比如你示例中已经处理好的srcBitmap图片字节
  • 追求代码简洁，不需要额外处理流逻辑
• appendInput+buildPacket的适用场景：
  • 上传大体积文件，比如几百MB的视频、压缩包，避免一次性加载全量字节到内存导致OOM
  • 数据是动态生成的，比如边加密边上传、边录制边上传的场景，不需要提前把全量数据存到内存或本地
  • 需要自定义写入逻辑，比如分片上传、断点续传这类需要分段写入数据的场景

补充说明：如果是上传本地存储的文件，Ktor还提供了直接传File对象的append重载，内部默认走流式处理，不用手动写buildPacket逻辑。

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