You need to enable JavaScript to run this app. 通过预签名URL从客户端上传文件到AWS S3时如何判断文件已上传完成?
优惠活动
大模型
产品
解决方案
定价
更多

通过预签名URL从客户端上传文件到AWS S3时如何判断文件已上传完成?

S3预签名URL上传完成的判断方法

1 基础判断方案(适配绝大多数场景)

你使用的axios.put本身返回Promise对象,只要该Promise成功resolve且响应状态码为200 OK,就代表AWS S3已经完整接收并存储了文件,上传完成。
你可以调整代码增加成功/失败的判断逻辑:

try {
  // 原获取预签名URL逻辑保持不变
  const { data } = await client.query({
    query: UPLOAD_URL,
    variables: { filename: file.name, filetype: file.type},
  })
  // 等待上传请求返回结果
  const uploadResponse = await axios.put(data.uploadUrl.url, file, { 
    headers: { 'Content-Type': file.type } 
  })
  // 状态码200即为上传成功
  if (uploadResponse.status === 200) {
    // 这里执行上传完成后的后续逻辑:比如提示用户、同步文件记录到后端等
    console.log('文件上传完成')
  }
} catch (error) {
  // 捕获上传失败异常,处理错误逻辑:比如重试、提示用户上传失败
  console.error('上传失败:', error)
}

2 进阶校验方案(确保文件完整性)

如果需要避免传输过程中文件损坏、内容被篡改的情况,可以加MD5校验逻辑:

  • 客户端先计算待上传文件的MD5值,请求预签名URL时传给后端
  • 后端生成预签名URL时指定Content-MD5校验规则
  • 上传时把计算好的MD5值放到请求头中,S3会自动校验接收文件的MD5是否匹配,只有匹配成功才会返回200状态码,确保上传的文件和本地文件完全一致。

3 大文件上传场景的进度+结果双重判断

如果是大文件上传,你可以通过onUploadProgress监听上传进度,给用户展示进度条,但注意不能仅靠进度到100%判断上传完成,因为这只代表客户端已经把所有数据发出去,还要等S3返回200响应才是最终成功:

const uploadResponse = await axios.put(data.uploadUrl.url, file, { 
  headers: { 'Content-Type': file.type },
  // 监听上传进度
  onUploadProgress: (progressEvent) => {
    const percent = Math.round((progressEvent.loaded * 100) / progressEvent.total)
    console.log(`当前上传进度:${percent}%`)
    // 这里可以更新页面上的进度条展示
  }
})

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.16 10:36:04