如何使用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:AbortMultipartUploads3:ListMultipartUploadPartss3:ListBucketMultipartUploads
缺少上述权限是最常见的无报错卡住原因。
- 分片大小规则:
partSize配置不能低于5MB(仅最后一个分片可以小于5MB),否则会触发S3接口限制。 - 入参格式校验:移动端调用时不要直接传入本地文件路径字符串,需要先通过平台原生API将本地文件转换为标准Blob/File对象后再传入接口。
可选调试方案
如果仍无法定位问题,可以开启Amplify调试日志查看底层请求详情:Amplify.Logger.LOG_LEVEL = 'DEBUG'
开启后即可在控制台查看Storage模块的完整请求和报错信息,快速定位问题点。
内容的提问来源于stack exchange,提问作者Vingtoft
相关产品推荐
相关产品推荐

