HarmonyOS OBS 云相册:从签名上传到可核验备份

举报
xinxin9527 发表于 2026/11/10 09:12:21 2026/11/10
【摘要】 基于 HarmonyOS-APP-OBSCloudAlbum 的公开实现,梳理 OBS Header 签名、对象键去重、预览缓存和 403 排障,并给出可以逐项核验的落地清单。

相册备份的难点不只在把文件传到云端。用户取消、重复选择、网络中断、切换桶和目标隔离,都会影响下一次备份是否可靠。HarmonyOS-APP-OBSCloudAlbum 用 ArkTS、ArkUI 和 OBS REST API 给出了一条完整链路,适合拆开看它的工程边界。

把认证收在独立客户端

应用从设置页读取 AK、SK、Endpoint 和桶名,OBS 请求统一交由 ObsClient 处理。签名串由 HTTP 方法、Content-MD5、内容类型、日期、规范化 OBS 请求头和资源组成,再用 SK 计算 HMAC-SHA1,最后生成 Authorization: OBS AK:Signature。

实现上有三个必须守住的点:

  • Endpoint 只填写区域域名,不要把桶名或完整对象 URL 混进去;
  • 参与签名的请求头与实际发送的请求头必须一致;
  • AK 和 SK 不进入日志、截图、异常信息或公开 Issue。设置页的密码态只能遮住输入,教学环境仍会把它明文保存在应用沙箱里。

对象键和本地记录一起做去重

案例使用 photo_backup/v2/SHA256(localUri,size,modifiedAt,md5)/safeName 作为对象键。这个组合同时覆盖文件来源、大小、修改时间和内容摘要,比只看文件名更能识别同名但内容不同的文件。

只靠对象键还不够。应用还把备份记录按 Endpoint 和桶隔离,并在云端用 ETag 参与核验。这样切换到另一个目标时不会误用旧记录,重复备份也能跳过已经完成的文件。取消的当前文件需要整份重传,不能把逐文件恢复说成字节级断点续传。

给大文件和预览缓存设硬边界

单文件上传和预览上限都是 64 MiB。更大的视频不会悄悄截断,而是提示超出限制。预览缓存设置 128 MiB 磁盘上限,最多保留 64 张缩略图,避免为了浏览云端对象把设备空间吃满。

这些限制也说明了下一步扩展的方向。超过 64 MiB 的视频应使用 OBS 分段上传,并单独处理初始化、分段、合并、失败和取消。分段 ETag 不能当作整文件 MD5,清理未完成上传也要有明确流程。

403 的排查顺序

遇到 SignatureDoesNotMatch 或 403,先核对 Endpoint 和桶名,再检查 AK/SK、设备和系统时间、请求权限以及规范化资源。只有确认实际响应后,才调整签名串。把所有 403 都归因于密钥错误,会掩盖桶权限和网络请求格式的问题。

验收清单

  • 用非敏感测试照片完成一次上传,并在桶里找到对应对象;
  • 重复备份同一文件时能够跳过,改名但内容不同的文件不会被误判;
  • 切换 Endpoint 或桶后,旧记录不会串到新目标;
  • 取消后再次备份只继续未完成文件,当前文件完整重传;
  • 403 场景能够根据实际响应定位到凭据、时间、权限或签名问题;
  • 测试结束删除临时对象,并按实际桶配置处理版本和未完成上传。

案例仓库:HarmonyOS-APP-OBSCloudAlbum

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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