鸿蒙云相册学习笔记:OBS Header签名、MD5去重与DevSpace实测

举报
yd_224048907 发表于 2026/11/17 00:38:43 2026/11/17
【摘要】 今天的学习主线是鸿蒙开发实践中心的一个进阶案例《用OBS打造个人云相册app》,随后又在华为云 AI DevSpace 免费体验版里围绕这个案例向 AI 提了三个问题、逐一得到了完整回复。这篇笔记把案例的关键机制和 DevSpace 实测的结论整理在一起,既是当天的学习记录,也方便以后照着复现。 一、案例速览:一个云相册要解决什么问题案例定位是鸿蒙端云一体、ArkTS/ArkUI、进阶难度,...

今天的学习主线是鸿蒙开发实践中心的一个进阶案例《用OBS打造个人云相册app》,随后又在华为云 AI DevSpace 免费体验版里围绕这个案例向 AI 提了三个问题、逐一得到了完整回复。这篇笔记把案例的关键机制和 DevSpace 实测的结论整理在一起,既是当天的学习记录,也方便以后照着复现。

一、案例速览:一个云相册要解决什么问题

案例定位是鸿蒙端云一体、ArkTS/ArkUI、进阶难度,官方建议学习时长 120 分钟,目标 API 版本是 26。它的场景很具体:手机相册里的照片越来越多,只存在本地既怕丢、换机又麻烦;于是做一个云相册 App,把照片备份到华为云对象存储 OBS,支持浏览、时间轴展示、文档备份和云端下载恢复,核心亮点是端侧直传 OBS——照片不经过自建业务服务器中转。

案例给出的完整链路是:端侧读取相册 → 计算 MD5 → 按 MD5 组织对象名 → 用 OBS Header 签名发起 PUT 上传 → 预览走缓存与缩略图 → 需要时从云端下载恢复。代码仓在 GitCode 的 harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum。先把这条链路记在心里,后面每个环节都可以单独展开成一个技术点。

二、核心机制一:OBS Header 签名是怎么算出来的

这是整个案例最值得抠细节的部分。端侧直传 OBS 必须证明“这个请求是得到授权的”,做法是在请求头里带上 Authorization: OBS AK:Signature,其中 Signature 是用 SK 对 CanonicalString 做 HMAC-SHA1 再 Base64 编码的结果。

CanonicalString 的拼接顺序是固定的:HTTP-Verb + 换行 + Content-MD5 + 换行 + Content-Type + 换行 + Date + 换行 + CanonicalizedHeaders + CanonicalizedResource。也就是说,先是请求方法(如 PUT),然后依次是内容 MD5、内容类型、日期、规范化后的 x-obs- 开头自定义头(按字典序排列,形如 key:value 加换行),最后是规范化后的资源路径(桶名 + 对象名 + 子资源)。任何一部分多一个空格、少一个换行,签名都会对不上,OBS 就会返回签名错误——这是初学者最容易踩的坑。

为什么案例坚持用 Header 签名而不是 URL 签名?我向 DevSpace 的 AI 请教后得到的结论是:URL 签名把 AK、Signature 和 Expires 都拼在 URL 里,URL 会进浏览器历史、代理日志和 Referer,泄露面更大,而且有效期是写死在链接里的,不适合需要精细控制的上传;Header 签名则把签名放在请求头里,不进 URL,配合 Date 头做时效校验,更适合端侧直传这种“请求体较大、需要自定义头”的场景。当然,两种签名本质上都是同一套 HMAC-SHA1 算法,只是载体不同。

安全上最关键的一点是:AK 和 SK 绝不能硬编码在端侧代码或写进公开仓库。一旦泄露,任何人都能以你的身份调用 OBS,轻则产生流量与存储费用,重则删改桶内对象。正确的做法是走“临时凭证 + 服务端签发”的路线:由可信服务端持有长期 AK/SK,端侧每次上传前向服务端申请临时 AK/SK/Token 和一个短期有效的签名策略,或者至少让服务端代签;同时给 AK 只授予最小权限(比如仅允许 PutObject 到指定前缀),并开启访问日志与用量告警。案例为了教学演示把签名过程放在端侧讲清楚,但落到生产环境时,这一步必须收回到服务端。

三、核心机制二:photoAccessHelper 读取相册

端侧第一步是拿到照片。鸿蒙提供的是 photoAccessHelper,而不是直接读文件路径。需要申请的权限包括读取图片与视频的权限(ohos.permission.READ_IMAGEVIDEO),以及按需的写权限;从鸿蒙较新版本开始,系统对相册访问做了“选图器 + 受限访问”的收敛,App 只能拿到用户明确授权范围内的媒体,这比直接扫全盘目录要克制得多。

photoAccessHelper 返回的是 photoUri,形如 datashare 协议的 URI,它不是文件系统路径,不能直接当作 path 传给文件 IO。正确用法是先通过 photoAccessHelper 的接口拿到 PhotoAsset,再用系统接口打开文件描述符、按流读取。这一点对从 Android 转过来的开发者尤其重要:Android 上习惯的“拿 path 直接 open”的写法在鸿蒙上行不通。

在读取时还要注意两点:一是用户随时可能在系统设置里收回权限,读取失败时要有明确的引导而不是闪退;二是相册可能包含 LivePhoto、动图和长视频,读取前应当先按类型和大小过滤,避免把不该备份的大文件也塞进上传队列。案例的做法是先取元数据、再决定是否备份,这个顺序值得照搬。

四、核心机制三:MD5 去重、目标隔离与防覆盖

案例的备份策略是“按 MD5 逐文件备份到 MD5 目标隔离路径”,同时上传时设置 x-obs-forbid-overwrite 请求头。这里其实是三个互相配合的设计。

第一,MD5 去重。同一张照片可能在相册里出现多次(比如微信保存了一份、原图又有一份),按内容算 MD5 后,相同内容的照片得到相同的对象名,第二次上传时服务端已经有这个对象,就可以跳过,既省流量又省存储。MD5 冲突在理论上存在,但对于相册备份这种场景,128 位摘要的随机冲突概率可以忽略;真正要注意的是“同内容不同元数据”的情况——比如同一张照片被重新编码后 MD5 就变了,去重会失效,这时可以把拍摄时间、尺寸等元数据也纳入比对。

第二,大文件算 MD5 的性能。一次把几百兆视频读进内存再算 MD5 是不可取的,正确做法是流式计算:用 buffer 分块读取、边读边更新摘要对象,内存占用只取决于分块大小;也可以在后台任务里算,并把已算出的 MD5 持久化到本地数据库,同一文件下次直接命中缓存,不必重复计算。

第三,目标隔离与防覆盖。按 MD5 组织对象名(例如 photos/加 MD5 前两位再加完整 MD5 作为对象名)天然起到了“按内容隔离”的作用;而 x-obs-forbid-overwrite 的作用是告诉 OBS:如果目标对象已经存在,这次上传必须失败而不是静默覆盖。没有这个头时,重复上传会直接覆盖旧对象——如果旧对象被别的业务引用,或者覆盖发生在上传中途被打断,就可能留下一个不完整的新版本。设置该头之后,重复上传会明确报错,端侧可以据此判断“已经备份过”,把错误当作去重成功的信号处理。

五、核心机制四:分段上传与 64MiB 上限

案例明确写了单文件上限 64MiB,超过这个大小的文件要做分段上传。分段上传在 OBS 上是一个标准的三步流程:第一步,发起分段上传请求,OBS 返回一个 uploadId;第二步,把文件按固定大小(比如每段 5MiB 或更大)逐段上传,每段返回一个 ETag,端侧要按段号记录这些 ETag;第三步,所有段都传完后,发起合并请求,把段号与 ETag 列表交给 OBS,由服务端拼成完整对象。

这套流程的好处是断点续传:中途断网后,只需要重新上传失败的那几段,已经成功的段不用重传;同时多段还可以并行上传,压满带宽。需要注意的细节是:分段上传必须设置合理的段大小——太小会导致请求数过多,太大会让单段失败的重传代价变大;另外,未完成的分段上传会占用存储、产生费用,长时间未合并的 uploadId 要记得清理。

六、预览缓存、时间轴与下载恢复

备份只是云相册的一半,另一半是“看得顺”。案例给出的约束是:预览缓存 128MiB,缩略图最多 64 张。我的理解是:端侧缓存要分层——内存里只放当前屏幕附近的缩略图,磁盘缓存放 128MiB 的缩略图与原图,超过上限按 LRU(最近最少使用)淘汰;64 张这个上限是“首屏加预加载”的取舍,缩略图先行、原图按需加载,滑动越快、预加载越要克制,否则流量和内存都会被打爆。

时间轴分组在端侧的实现,关键是“取元数据再分组”:读取每张照片的拍摄时间(photoUri 对应的 PhotoAsset 元数据里有),按年、月、日分组,列表按时间倒序、分页加载;分组头只渲染一次,滚动时用懒加载补齐下一页,而不是一次性把全部照片对象都查出来。

文档备份与照片备份的区别在于对象命名与权限:照片按 MD5 组织,读策略可以放宽;文档则建议按用户或类型分目录、并收紧读权限,避免把私人文件暴露给不该看到的人;备份时也要区分“可公开的媒体”与“私有的文档”,不要用同一套权限一把梭。

下载恢复要保证两点:一是断点续传,下载时带 Range 头、记录已下载字节数,断网后从断点继续;二是本地已存在的文件不重复下载,下载前先拿本地文件的 MD5 与云端对象的 ETag 或元数据比对,相同就跳过。把这两点做扎实,换机恢复时才能做到“只下缺失的部分”,而不是把整个相册重新拉一遍。

七、DevSpace 实测:我问 AI 的三个问题

今天的 DevSpace 体验用的是免费体验版(不消耗核时),新建了一个 AI 对话会话,会话名是“鸿蒙OBS云相册签名机制与安全风险”。我围绕案例提了三个问题,AI 每次都先联网查阅官方文档再给出结构化回复,三次回复都完整生成完毕。

第一个问题是 CanonicalString 的拼接顺序、Header 签名与 URL 签名的取舍、AK/SK 泄露的风险与规避。AI 的回复核对了我对签名算法的理解,并补充了“服务端签发临时凭证加最小权限加用量告警”这条生产落地的路线,这也是本文第二部分的主要依据。

第二个问题是 photoAccessHelper 的权限与 photoUri 特点、MD5 去重的冲突与性能、x-obs-forbid-overwrite 的作用、分段上传的完整流程。AI 给出的答案包括流式计算 MD5 的示例思路和分段上传的三步法,与案例文档相互印证,本文第三至第五部分据此写成。

第三个问题是 128MiB 预览缓存与 64 张缩略图上限的取舍、时间轴分组的实现、文档与照片备份在命名与权限上的差异、下载恢复的断点续传与去重,以及给相册加全文搜索与分享功能时端侧与 OBS 侧分别要做什么。AI 的建议是:搜索可以在端侧建本地索引(标题、时间、地点)并把对象元数据同步到服务端检索;分享则用带有效期的临时签名 URL,而不是把桶设成公开读。本文第六、第八部分吸收了这些结论。

三次提问结束后,我点了容器右上角的“释放”,确认释放后环境与数据被销毁,容器回到未启动状态,整个体验过程没有消耗核时。值得一提的是:本次体验全程没有出现“同步临时访问凭据(AK/SK)至 AI Shell”的协议弹窗,我也没有勾选或确认过任何此类授权。

八、延伸思考:如果继续做下去,我会先做哪三件事

第一件事是把签名收回服务端。按本文第二部分的结论,端侧只拿临时凭证,服务端负责签发与鉴权,这是从“教学演示”走向“能上线”的分水岭。

第二件事是给相册加上本地检索。先从最简单的做起:按拍摄时间、地点和文件名建本地索引,支持关键字搜索;等数据量上来后,再把对象元数据同步到服务端做全文检索。

第三件事是分享功能。用带有效期的临时签名 URL 做分享链接,链接过期即失效;同时给分享加上访问次数与下载权限的控制,避免一张分享链接被无限转发。

九、总结:今天学到的检查清单

  • OBS Header 签名的 CanonicalString 由方法、Content-MD5、Content-Type、Date、规范化自定义头、规范化资源六部分按固定顺序拼接,HMAC-SHA1 后 Base64 编码,放在 Authorization 头里。
  • photoAccessHelper 返回的是 datashare 协议的 photoUri,不是文件路径,必须通过系统接口按流读取。
  • MD5 去重按内容组织对象名,流式计算控制内存,x-obs-forbid-overwrite 防止静默覆盖。
  • 超过 64MiB 的文件走“初始化分段上传、逐段上传、合并”三步,断点续传只补传失败的段。
  • 预览缓存 128MiB 分层、缩略图 64 张上限、时间轴按拍摄时间分组分页、下载恢复用 Range 续传与 MD5 比对去重。
  • DevSpace 免费体验版可以完整走通“新建会话、提问、等完整回复、释放容器”的流程,不消耗核时。

案例地址:鸿蒙开发实践中心《用OBS打造个人云相册app》;代码仓:GitCode harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum。这篇笔记是今天学习过程的原创整理,文中结论以案例文档与 DevSpace 实测回复为依据,后续我会按第八部分的计划继续完善这个云相册。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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