从 OBS 云相册案例看 HarmonyOS 端云协同的三个关键设计点
引言
鸿蒙应用做照片与视频备份,绕不开三个问题:对象存储鉴权怎么做、端侧状态如何组织、失败与重试怎么兜底。本文基于华为云开发者成长中心的「用OBS打造个人云相册app」案例,拆解一套可落地的端云协作方案,并给出实践过程中整理的工程化改进建议。
一、OBS 的 Header 签名:把密钥留在端侧的代价
案例使用 HMAC-SHA1 构造 Authorization 请求头,由端侧直接计算签名。这在演示场景足够,因为桶是测试桶、权限最小化;但生产环境必须把 AK/SK 收到服务端,常见做法有三条:
- 端侧只申请短期 STS 令牌,签名放到云函数或网关完成;
- 使用预签名 URL,让 OBS 自己承担鉴权,端侧只负责 PUT/GET;
- 对桶设置最小权限策略,禁止 ListAllMyBuckets 这类列举权限。
我在本地按案例跑通后,用接口工具复算了签名串:
StringToSign = HTTP-Verb + “\n” + Content-MD5 + “\n” + Content-Type + “\n” + Date + “\n” + CanonicalizedResource
三个细节最容易踩坑:Content-Type 必须与实际上传一致、Date 必须是 GMT 格式、CanonicalizedResource 要带上桶名与对象键。少任何一项,服务端都会返回签名不匹配。
二、端侧状态管理:把「备份任务」建模为一等公民
相册备份不是一次请求,而是一组有生命周期的工作单元。用 ArkUI 的 @Observed 加 @ObjectLink 管理每个文件的上传状态,比把所有进度塞进一个数组更稳:
-
待备份、上传中、成功、失败、已取消,用枚举而不是布尔位;
-
每个任务单独维护进度与重试次数;
-
页面销毁时只取消 UI 订阅,不强制中断已提交的请求,避免产生半成品对象。
enum BackupState { Pending, Uploading, Success, Failed, Canceled }
@Observed class BackupTask {
file: photoAccessHelper.PhotoAsset
state: BackupState = BackupState.Pending
progress: number = 0
retries: number = 0
}
状态拆开之后,列表刷新只重绘变化的行,长列表滚动也不会因为一个大对象整体变更而卡顿。
三、失败兜底:幂等、去重与可观测
照片备份的典型故障是网络抖动导致的重复上传。案例里用对象键做去重,我进一步补了两点:
- 对象键使用文件内容哈希作为前缀,内容相同即天然幂等;
- 失败任务指数退避重试,最多三次,超过后进入人工确认队列;
- 用 HiLog 记录 taskId、对象键、耗时与错误码,方便定位问题。
除此之外,视频文件建议走分段上传,并在合并前校验分片数量与 ETag,避免出现「对象存在但无法播放」的假成功。
四、给案例的两条改进建议
- 案例文档可以补充「预签名 URL」的对照实现,便于读者理解为什么演示代码不适合直接上线;
- 提供一份最小权限的桶策略示例,只允许 PutObject 与 GetObject,减少读者在权限配置上的试错成本。
小结
OBS 云相册案例的价值不在于「能跑」,而在于它把端云协作的骨架完整摆了出来。把签名收归服务端、把上传任务建模为状态机、把失败重试做成可观测流程,这三步做完,演示代码才具备走向生产的可能。
- 点赞
- 收藏
- 关注作者
评论(0)