使用@aws-sdk/lib-storage的Upload类分片上传S3请求体不完整问题

可能原因 #

• SDK版本bug：旧版本的@aws-sdk/lib-storage或依赖的@aws-sdk/client-s3在浏览器环境下处理分片上传时，存在XML序列化逻辑缺陷，导致成功上传的分片信息（parts）未被正确写入CompleteMultipartUpload的请求体。
• 分片上传异常未捕获：大文件分片过程中，某片上传失败但未被捕获，导致Upload类无法收集完整的分片成功记录，最终生成不完整的请求体。
• 自定义请求拦截器干扰：如果给s3Client配置了自定义middleware（请求拦截器），可能在处理CompleteMultipartUpload请求时意外篡改或删除了Parts参数。
• 浏览器内存/超时限制：默认分片大小过大，浏览器处理时因内存不足或请求超时，导致分片信息丢失。

解决方法 #

1. 升级SDK至最新稳定版
   执行命令更新依赖：

   npm update @aws-sdk/lib-storage @aws-sdk/client-s3
   

   多数旧版本的分片上传序列化bug已在后续版本中修复。

2. 完善错误捕获逻辑
   在upload.done()中添加错误处理，定位具体分片上传失败的原因：

   return upload.done().catch(err => {
     console.error('分片上传失败详情:', err);
     throw err;
   });
   

   捕获到具体错误后，可针对性解决分片上传失败的问题（如调整超时时间、检查权限等）。

3. 排查自定义请求拦截器
   检查s3Client的middleware配置，确保没有修改CompleteMultipartUpload请求的Parts字段。例如，若有自定义请求处理器，需确认它仅处理必要逻辑，不干扰分片参数。

4. 显式指定分片大小
   手动设置合理的分片大小（如10MB），避免默认大小引发的浏览器内存问题：

   const upload = new Upload({
     client: s3Client,
     params: params,
     partSize: 10 * 1024 * 1024, // 10MB每片
   });
   

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