OSS 预签名 URL 5 分钟就 403:签名过期和时钟怎么对

前端直传图片,后端签发预签名 URL,有效期设的 3600 秒。测试同学反馈上传到一半报 403,返回体里 Code 是 SignatureDoesNotMatch,RequestId 有值。复现时发现根本不到一小时,五分钟后的链接就废了。

第一反应是时间算错。签发代码用的是 new Date(System.currentTimeMillis() + 3600 * 1000),看着没问题。又怀疑容器时钟漂移,进 Pod 跑 chronyc tracking,offset 0.0004 秒,宿主机和 NTP 都对得上,排除。

把有效期改成 7200 再试,五分钟照样 403。过期的话返回的应该是 AccessDenied 或者 ExpiredToken,不该是签名不匹配。这个错误码的区分很重要,一开始没注意,白查了两小时。

接着对比签发时的 URL 和实际请求的 URL。服务端日志里那条签名,Signature 里带加号,浏览器发出去的请求里加号变成了空格。原因是后端拼查询串时直接字符串相加,没有对 Signature 做 URL 编码,经过一层 Nginx 和一层 CDN,加号被当成了空格的转义。

顺手还发现 SecretKey 换成新版之后带斜杠,同一段签名里的斜杠没编码,某些客户端会把它当路径分隔符截断,报出来也是 SignatureDoesNotMatch。

换成 SDK 的 generatePresignedUrl,编码交给它处理,业务侧只负责把字符串原样返回给前端,不做任何二次 encode。

Date exp = new Date(System.currentTimeMillis()
    + 3600L * 1000);
URL url = client.generatePresignedUrl(bucket, key, exp);
return url.toString();

如果一定要自己拼,至少对整个 query 走一遍 encodeURIComponent,且只走一次。前端拿到后再 encode 一次是最常见的双编码,签名同样对不上,抓包看到 %2B 变成 %252B 就能认出来。

确认方式:批量签 200 个 URL,用脚本逐个 PUT 一个 1KB 的文件,200 全成功;再把系统时间往后调 3610 秒重试,返回 AccessDenied,说明有效期确实在生效,而不是碰巧能用。

跨域那边也补了一条,bucket 的 CORS 要放行 PUT 和 Content-Type,否则预检就挂,报错和签名无关,但同样表现为上传失败。

您可以还会对下面的文章感兴趣: