HarmonyOS 端云协同实战:OBS 云相册的签名直传、队列重试与备份记录设计

举报
yd_272402707 发表于 2026/11/17 00:35:55 2026/11/17
【摘要】 一、背景:为什么选择端云协同的相册备份手机相册是最典型的"重资产"数据:单个用户动辄几十 GB,且以图片、短视频这类非结构化文件为主。如果应用采用"先上传到业务服务器、再由服务器转发到对象存储"的中转方案,带宽和存储成本会翻倍,业务服务器也很容易成为瓶颈。在鸿蒙端云协同实践中,更合理的路径是:端侧直传对象存储(OBS),云侧只负责签名与元数据。本文结合笔者的实践,梳理这套方案在 Harmo...

一、背景:为什么选择端云协同的相册备份

手机相册是最典型的"重资产"数据:单个用户动辄几十 GB,且以图片、短视频这类非结构化文件为主。如果应用采用"先上传到业务服务器、再由服务器转发到对象存储"的中转方案,带宽和存储成本会翻倍,业务服务器也很容易成为瓶颈。

在鸿蒙端云协同实践中,更合理的路径是:端侧直传对象存储(OBS),云侧只负责签名与元数据。本文结合笔者的实践,梳理这套方案在 HarmonyOS 上的关键实现点,包括预签名直传、上传队列、断点重试和备份记录设计。文中不包含任何真实密钥,示例代码仅用于说明思路。

二、整体架构

方案分为三层:

  1. 端侧 ArkTS 应用:负责读取相册、生成上传任务、管理本地备份记录。
    1. 签名服务:运行在云函数或容器中,持有 AK/SK,按需签发短时效的 PUT/GET 预签名 URL。

      1. 对象存储 OBS:私有桶,按用户维度划分前缀,例如 users/{uid}/photos/{yyyymm}/。

      2. 端侧永远拿不到长期 AK/SK,只拿到"一次上传、几分钟有效"的预签名地址。即使预签名 URL 被截获,攻击者也只能在有效期内向指定对象键写入内容,风险可控。

    2. 三、相册读取:从 PhotoAccessHelper 开始

  2. 鸿蒙提供了 @ohos.file.photoAccessHelper 用于访问媒体库。申请 ohos.permission.READ_IMAGEVIDEO 后,可以按时间倒序拉取图片:
import { photoAccessHelper } from '@kit.MediaLibraryKit';

const helper = photoAccessHelper.getPhotoAccessHelper(context);
const fetchOpt: photoAccessHelper.FetchOptions = {
  fetchColumns: [photoAccessHelper.PhotoKeys.URI, photoAccessHelper.PhotoKeys.DISPLAY_NAME, photoAccessHelper.PhotoKeys.SIZE],
  predicates: new photoAccessHelper.DataSharePredicates(),
};
const result = await helper.getAssets(fetchOpt);

拿到 uri 后,用 @ohos.file.fs 打开文件并读成 ArrayBuffer,作为 PUT 的请求体。这里要注意:不要在主线程一次性读入超大视频,建议设置单文件大小阈值(例如 20 MB 以上走分片或交给系统上传任务),避免内存抖动。

四、预签名直传:端侧只做一件事

签名服务对每个对象键计算签名,返回类似下面的结构:

interface UploadTicket {
  objectKey: string;
  putUrl: string;     // 带签名参数的 PUT 地址
  getUrl: string;     // 用于预览的 GET 地址
  expiresAt: number;  // 毫秒时间戳
}

端侧用 @ohos.net.http 发起 PUT:

import { http } from '@kit.NetworkKit';

const req = http.createHttp();
const res = await req.request(ticket.putUrl, {
  method: http.RequestMethod.PUT,
  header: { 'Content-Type': 'image/jpeg' },
  extraData: buffer,
  expectDataType: http.HttpDataType.STRING,
});
if (res.responseCode !== 200) {
  // 进入失败重试队列
}
req.destroy();

几个容易踩的坑:

  • Content-Type 必须与签名时一致。签名串里如果带了这个头,端侧改了就会 403。
    • 预签名有效期不要设太长,5 到 10 分钟足够一次上传;失败后重新申请即可。

      • 桶必须是私有读,预览走 GET 预签名 URL,不要为了省事开公共读。

      • 五、上传队列:并发、退避与状态机

    • 相册备份是典型的批量异步任务,最怕两种情况:一是并发过高把手机网络打满,二是失败任务无声无息地消失。笔者的做法是维护一个持久化的任务表,每条记录包含:

    • localUri:本地资源标识;
      • objectKey:云端对象键;

        • state:pending / uploading / success / failed;
          • retry:已重试次数;

            • updatedAt:最后更新时间。

            • 调度器固定并发为 2,取 pending 和 failed 且 retry < 3 的任务执行。失败后按 2 秒、8 秒、30 秒做指数退避。应用被杀后重启,任务表仍在,可以从断点继续,而不是从头扫描整个相册。

          • 六、备份记录:Preferences 足够,但要注意写入频率

        • 备份记录本质是"键值 + 少量结构化字段",用 @ohos.data.preferences 就够:
      • import { preferences } from '@kit.ArkData';
        
        const store = await preferences.getPreferences(context, 'backup_records');
        await store.put(task.objectKey, JSON.stringify(task));
        await store.flush();
        

        注意 flush() 是落盘操作,不要每上传一个分片就调用一次。笔者的策略是:内存中维护状态,每完成一个文件或每 5 秒聚合落盘一次。记录数量很大时(例如数万条),Preferences 的全量序列化会变慢,此时应换成关系型数据库 @ohos.data.relationalStore,按 state 建索引。

        七、云端预览与缓存

        预览时向签名服务申请 GET URL,直接交给 Image 组件加载。为了避免每次滑动都重新签名,可以在内存中缓存 objectKey -> {url, expiresAt},过期前 60 秒再刷新。端侧再配合 @ohos.file.fs 的缓存目录做一层磁盘缓存,弱网体验会好很多。

        八、安全与成本的两点提醒

        1. 最小权限:签名服务使用的 AK/SK 应绑定到只允许操作指定桶前缀的委托策略,而不是主账号的长期密钥。

          1. 成本控制:开启生命周期规则,把超过一定时间的原图转为低频或归档存储;同时限制单用户配额,避免异常客户端无限上传。

          2. 九、小结

        2. 端云协同的相册备份,核心不是"把文件传上去",而是把签名、队列、记录、重试这四件事做扎实。端侧保持轻量,云侧守住密钥与策略,才能在体验、安全和成本之间取得平衡。以上代码为实践中的简化示例,落地时请结合最新 SDK 文档与自身业务做适配。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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