鸿蒙相册备份实战:OBS Header 签名的 4 个坑与 403 排查顺序

举报
yd_226289576 发表于 2026/11/15 11:54:03 2026/11/15
【摘要】 把鸿蒙相册备份到私有 OBS 桶时,签名错一个字符就是 403。记录四个实测坑:资源路径不能带域名、空头也要占位、Date 必须是 GMT、大文件要分段上传,附一条按顺序排查的清单。

为什么单独聊 OBS 签名

做鸿蒙相册云备份时,把照片视频直接推到自己的私有 OBS 桶是最省事的方案:不经过业务服务器,客户端算一个 Authorization 头就能 PUT。但它也是我调试时间最长的一段——因为 OBS 对签名错误一律返回 403 SignatureDoesNotMatch,不给具体哪一项算错了。这篇文章把踩过的四个坑和我的 403 排查顺序记下来,给同样在写这类备份功能的人省点时间。

背景:这个功能到底要做什么

典型链路是三步:

  • 用 photoAccessHelper 申请相册权限,选出待备份的照片和视频;
  • 对每个文件单独发一次 PUT 到 OBS,目标对象 key 做前缀隔离(例如 album/<设备标识>/<时间戳>-<原文件名>),避免同名覆盖;
  • 再用 GET 拉取缩略图或原图做云端预览,同时把备份记录落到本地数据库里。

每一步都要求同一个 Authorization 头,所以签名逻辑必须做对一次、复用到处。

坑 1:CanonicalizedResource 只写桶名和对象路径,不能带域名

签名串里的资源部分,格式是 /桶名/对象key。我第一次图省事,直接把完整 URL 塞进去了(https://obs.cn-north-4.myhuaweicloud.com/album/...),结果全部 403。规则很死:

CanonicalizedResource = "/" + bucketName + "/" + objectKey

域名、协议、端口一个都不能进。Endpoint 只参与建立连接,不参与签名。另外对象 key 里的中文和空格要注意:签名用的是原始 key,请求路径里也要保持一致,不要一边 URL 编码一边用未编码的 key 算签名。

坑 2:Content-MD5 和 Content-Type 必须和实际请求头逐字一致

OBS 的签名算法会把 Content-MD5、Content-Type、Date 这几个头参与计算。坑在于“没有也必须占位”:如果请求没带 Content-MD5,签名串里这一项要写成空字符串,但分隔用的换行符不能省。少一个 就是 SignatureDoesNotMatch。

我建议把签名串当成一个固定模板来拼,字段顺序不要凭记忆:

StringToSign =
    HTTP-Verb + "\n" +
    Content-MD5 + "\n" +
    Content-Type + "\n" +
    Date + "\n" +
    CanonicalizedHeaders +
    CanonicalizedResource

上传二进制文件时我倾向于真的算一遍 MD5 并带上这个头:既能让服务端做完整性校验,也顺手把“Content-MD5 为空但签名字段有值”这类不一致问题暴露在开发期。

坑 3:Date 头必须是 GMT 格式,设备时间偏差直接 403

Date 的格式是 RFC 1123 的 GMT 时间,例如 Sun, 15 Nov 2026 03:50:00 GMT。用本地时区拼出来的字符串一定错。更隐蔽的是设备时间本身:手机时间比标准时间快或慢超过 15 分钟,OBS 会以 RequestTimeTooSkewed 或 403 拒绝,签名算得再对也没用。

排查时我养成一个习惯:先在代码里把 Date 和 StringToSign 打到日志里(脱敏后),再和服务端返回的 RequestId 一起看。很多“签名不对”其实是时间不对。

坑 4:单文件上传有上限,大视频要走分段上传

这个案例里单文件 PUT 的上限是 64 MiB,云预览的磁盘缓存上限 128 MiB、缩略图最多 64 张。所以家庭视频这类素材,别指望一次 PUT 搞定,要么在 UI 上明确提示“超过 64 MiB 请用分段上传”,要么直接实现分片 + 合并。分段上传的每一片都要各自签名,签名串里的资源还要带上 ?partNumber=N&uploadId=xxx 这类子资源,这部分是最容易漏签的。

我的 403 排查顺序

按这个顺序查,基本三步内能定位,不用瞎改代码:

  1. 四项配置:AK、SK、Endpoint、桶名。Endpoint 不能带桶名、不能带协议和端口;桶名不能是文件夹名。
  2. 设备时间:和标准时间对齐到分钟级以内。
  3. 桶策略与权限:桶是私有的没错,但 IAM 用户要真的有 obs:bucket:ListBucket、obs:object:PutObject、obs:object:GetObject。只给了读权限去 PUT,同样是被拒。
  4. 签名串对比:把客户端拼出来的 StringToSign 和文档示例逐字符比对,重点看换行符数量、头的大小写、子资源排序。

最后一点经验:AK/SK 只在 App 的设置页里填,不要写进源码、日志截图或任何聊天窗口。真要用,就建一个只对测试桶有权限的专用 IAM 用户,把影响范围圈死。

小结

OBS 签名本身不复杂,复杂的是它不告诉你哪里错。把签名串模板固定下来、把 Date 和日志打通、把权限一次配到位,这功能就能从“时好时坏”变成稳定可用的相册云备份。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。