HarmonyOS OBS 云相册:从签名上传到可核验备份
相册备份的难点不只在把文件传到云端。用户取消、重复选择、网络中断、切换桶和目标隔离,都会影响下一次备份是否可靠。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 场景能够根据实际响应定位到凭据、时间、权限或签名问题;
- 测试结束删除临时对象,并按实际桶配置处理版本和未完成上传。
- 点赞
- 收藏
- 关注作者
评论(0)