鸿蒙相册备份实战:OBS Header 签名的 4 个坑与 403 排查顺序
为什么单独聊 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 排查顺序
按这个顺序查,基本三步内能定位,不用瞎改代码:
- 四项配置:AK、SK、Endpoint、桶名。Endpoint 不能带桶名、不能带协议和端口;桶名不能是文件夹名。
- 设备时间:和标准时间对齐到分钟级以内。
- 桶策略与权限:桶是私有的没错,但 IAM 用户要真的有
obs:bucket:ListBucket、obs:object:PutObject、obs:object:GetObject。只给了读权限去 PUT,同样是被拒。 - 签名串对比:把客户端拼出来的 StringToSign 和文档示例逐字符比对,重点看换行符数量、头的大小写、子资源排序。
最后一点经验:AK/SK 只在 App 的设置页里填,不要写进源码、日志截图或任何聊天窗口。真要用,就建一个只对测试桶有权限的专用 IAM 用户,把影响范围圈死。
小结
OBS 签名本身不复杂,复杂的是它不告诉你哪里错。把签名串模板固定下来、把 Date 和日志打通、把权限一次配到位,这功能就能从“时好时坏”变成稳定可用的相册云备份。
- 点赞
- 收藏
- 关注作者
评论(0)