阿里云OSS使用预签名URL上传文件,状态码返回403,报SignatureDoesNotMatch异常

1. 背景

  • 前端使用 Vue.js,后端使用 Springboot 和 aliyun-sdk-oss
  • 使用阿里云 OSS 使用预签名URL上传文件,异常返回 SignatureDoesNotMatch 错误码 0002-00000201。
  • 异常信息如下:
xml 复制代码
<?xml version="1.0" encoding="UTF-8"?>
<Error>
    <Code>SignatureDoesNotMatch</Code>
    <Message>The request signature we calculated does not match the signature you provided. Check your key and signing method.</Message>
    
    <!-- 省略部分内容 -->

    <EC>0002-00000201</EC>
    <RecommendDoc>https://api.aliyun.com/troubleshoot?q=0002-00000201</RecommendDoc>
</Error>

2. 排查

  1. 根据 api.aliyun.com/troubleshoo... 逐一确认,Endpoint,AccessKey ID,AccessKey Secret 等参数均无误,排除配置参数问题
  2. 查看文档 Java 示例。先运行 Java 示例先生成预签名 url,再运行 Java 示例上传文件,上传成功。将预签名 url 放到前端调试,上传失败,同样异常返回 SignatureDoesNotMatch 错误码 0002-00000201。基本判断问题在前端。
  3. 查看文档 browser.js 示例,意外发现线索。基本确认问题在 Content-Type 请求头上。

如果您使用 Browser.js 上传文件时遇到 403 签名不匹配错误,通常是因为浏览器会自动添加 Content-Type 请求头,而生成预签名 URL 时未指定该请求头,导致签名验证失败。为解决此问题,您需要在生成预签名 URL 时指定 Content-Type 请求头。

3. 处理

  1. 参考文档,在后端代码添加 StorageClass 和 ContentType
java 复制代码
public String generatePresignedUploadUrl(String fileName) {
 // 指定生成的预签名URL过期时间,单位为毫秒。本示例以设置过期时间为1小时为例。
        Date expiration = new Date(new Date().getTime() + 3600 * 1000L);
        GeneratePresignedUrlRequest request = new GeneratePresignedUrlRequest(ossConfig.getBucketName(), fileName, HttpMethod.PUT);
        request.setExpiration(expiration);
        
        // 添加请求头
        Map<String, String> headers = new HashMap<>();
        // 指定StorageClass。
        headers.put(OSSHeaders.STORAGE_CLASS, StorageClass.Standard.toString());
        // 指定ContentType。
        headers.put(OSSHeaders.CONTENT_TYPE, "application/octet-stream");
        request.setHeaders(headers);
        
        URL url = ossClient.generatePresignedUrl(request);
        return url.toString();
}
  1. 参考文档,在前端代码添加相同的 StorageClass 和 ContentType
typescript 复制代码
      // 2. 使用预签名URL上传文件 - 使用PUT请求
      const uploadResponse = await fetch(presignedUrl, {
        method: 'PUT',
        body: file,
        headers: {
          'Content-Type': 'application/octet-stream',
          'x-oss-storage-class': 'Standard',
        },
      })
  1. 测试验证,上传成功。
相关推荐
码事漫谈1 天前
以后人人都可以成为导演
后端
Resean02231 天前
Spring 源码分析(二)配置类的解析与扫描
java·后端·spring
一只爱撸猫的程序猿1 天前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
北城笑笑1 天前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
ServBay1 天前
Local harness 将退役,VS Code 本地开发要不要搬到云端?
后端·ai编程·visual studio code
ashiho1 天前
【LeetCode hot 100】3. 无重复字符的最长子串 (三种解法)
java·数据结构·后端·算法·leetcode·滑动窗口
张一凡931 天前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
00后程序员1 天前
iOS 实时活动怎么开发,Windows 上用 KXBuild 和 ActivityKit 写灵动岛
后端·ios
程序员cxuan1 天前
推荐 10 个 WorkBuddy 中的邪修用法
人工智能·后端·程序员
Bacon1 天前
给项目做一次"全身 CT":Agent Skills 生态里的代码体检全链路
前端·人工智能·后端