You need to enable JavaScript to run this app. 如何使用AWS Amplify Storage实现大文件上传至AWS S3
优惠活动
大模型
产品
解决方案
定价
更多

如何使用AWS Amplify Storage实现大文件上传至AWS S3

AWS Amplify Storage 大文件上传解决方案

你遇到的无响应问题是默认Storage.put走单部分上传导致的:AWS S3 单部分上传的大小上限为5MB,超过该阈值且未开启分片上传时,就会出现Storage模块卡住、无报错无返回的情况,该问题在安卓、iOS双端均会触发。

Amplify Storage 已经内置了S3分片上传的完整封装,不需要手动拆分文件,仅需要调整调用参数即可实现大文件上传,操作方法如下:

核心调用代码

const uploadResult = await Storage.put(文件标识key, 文件Blob对象, {
  contentType: 文件MIME类型,
  // 开启分片上传能力
  resumable: true,
  // 配置单分片大小,单位为字节,最小为5MB
  partSize: 5 * 1024 * 1024,
  // 可选配置:监听上传进度
  progressCallback: (progress) => {
    console.log(`当前进度: ${Math.round((progress.loaded / progress.total) * 100)}%`)
  }
})

必要前置检查

完成上述配置后如果仍然出现异常,请逐一核对以下条件:

  • IAM权限配置:确保Amplify关联的S3访问IAM角色中,已经添加分片上传专属权限:
    • s3:AbortMultipartUpload
    • s3:ListMultipartUploadParts
    • s3:ListBucketMultipartUploads
      缺少上述权限是最常见的无报错卡住原因。
  • 分片大小规则:partSize配置不能低于5MB(仅最后一个分片可以小于5MB),否则会触发S3接口限制。
  • 入参格式校验:移动端调用时不要直接传入本地文件路径字符串,需要先通过平台原生API将本地文件转换为标准Blob/File对象后再传入接口。

可选调试方案

如果仍无法定位问题,可以开启Amplify调试日志查看底层请求详情:
Amplify.Logger.LOG_LEVEL = 'DEBUG'
开启后即可在控制台查看Storage模块的完整请求和报错信息,快速定位问题点。

内容的提问来源于stack exchange,提问作者Vingtoft

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.17 12:06:09