浏览器端实现S3分片上传：@aws-sdk/lib-storage不可用替代方案咨询

你之前遇到的导入@aws-sdk/lib-storage的报错是因为该包依赖Node.js核心API，确实无法在浏览器环境运行，浏览器端实现S3分片上传可选择以下两种最优方案：

方案一：使用@aws-sdk/client-s3原生API手动实现 #

这个包官方原生支持浏览器环境，按照标准S3分片上传流程实现即可，步骤如下：

• 初始化S3客户端，配置对应的区域、凭证信息，注意不要在前端硬编码永久AK/SK，建议通过后端接口获取STS临时凭证使用
• 调用createMultipartUpload接口创建分片上传任务，获取返回的唯一UploadId
• 用浏览器原生File.slice()方法将大文件切割为分片，单分片大小建议设置为5MB~500MB（除最后一个分片外，其余分片最小不能低于5MB）
• 并发上传所有分片，调用uploadPart接口上传每个分片，上传成功后记录对应分片的序号和返回的ETag值，并发数建议控制在3~5个，避免触发接口频率限制
• 所有分片上传完成后，调用completeMultipartUpload接口，传入记录的分片序号和ETag列表，S3会自动合并所有分片为完整文件

如果需要提升上传体验，可以额外补充两个优化逻辑：

• 断点续传：上传中断后调用listParts接口查询已上传成功的分片，无需重传已完成部分
• 错误重试：针对单次上传失败的分片，设置3次左右的自动重试机制，避免偶发网络波动导致上传失败

方案二：使用第三方封装库 #

如果不想手动实现全流程，可以选择专门针对浏览器环境封装的S3分片上传开源库，这类库通常已经内置了并发控制、断点续传、错误重试等通用能力，不需要自己从零造轮子，开发效率更高。

注意事项 #

• 提前配置S3存储桶的CORS规则，允许前端所在域名调用相关接口，避免跨域报错
• 分片数量最多不能超过10000个，切割分片时要注意控制分片大小和总数量

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