鸿蒙个人云相册案例实测:OBS Header 签名的三个关键点与 AI DevSpace 体验
今天在鸿蒙开发实践中心浏览了案例“用OBS打造个人云相册app”,又在 AI DevSpace 的 AI Shell 里请 AI 讲了一遍 OBS Header 签名。两边对照之后,把这次真实体验里值得记下来的内容写成这篇笔记:案例本身的做法、签名容易错的地方,以及 AI 回答要怎么核对。
一、案例做的是什么
案例用 ArkTS 与 ArkUI 做端侧相册,用华为云 OBS REST API 做云端存储,目标是做一个个人云相册 App。整体流程是:本地相册授权读取照片和视频,筛选、多选或一键备份全部待备份项,逐文件上传到自己的 OBS 桶;备份记录可以查看结果,云端图库支持列表与网格切换、缩略图以及图片和视频预览。
有几个实现细节值得记下来:
- 对象键使用 photo_backup/v2/ 前缀,由本地 URI、大小、修改时间与 MD5 等信息生成;备份记录按 Endpoint 和桶隔离。
- 已完成的文件会依据本地记录、MD5 和云端 ETag 核验跳过,避免重复上传;取消的当前文件需要整文件重新上传。
- 单文件上传和预览上限为 64 MiB,云预览磁盘缓存上限 128 MiB;当前不支持后台定时备份和字节级断点续传,大于 64 MiB 的视频需要另外做分段上传。
二、Header 签名的三个关键点
案例使用 OBS Header 签名:按官方规范构造规范化资源及 x-obs 请求头,使用 SK 计算 HMAC-SHA1 并做 Base64 编码,放到 Authorization: OBS AK:Signature 里。结合案例文档,三个关键点如下:
- 规范化要严。规范化资源与请求头的拼法、换行和编码必须与服务端算法一致,差一个字符就可能返回 403。遇到签名不匹配,先核对 Endpoint、桶名、AK、SK、设备时间、权限与规范化资源,再根据实际响应定位。
- 权限要最小。App 设置里要填 AK、SK、区域 Endpoint 和桶名,建议使用只授予目标桶 ListBucket、PutObject、GetObject 的专用 IAM 用户。AK 与 SK 虽然是密码态输入,但仍以明文保存在应用沙箱 preferences 中,只适合教学调试,绝不能提交到代码里,也不能发到聊天和截图中;生产环境要采用适当的临时授权方案。
- 同名对象要防覆盖。上传使用 x-obs-forbid-overwrite;桶启用版本管理时,删除当前对象不一定删除历史版本,清理要按控制台实际版本核对并确认费用。
三、AI DevSpace 的回答要核对
在 AI DevSpace(体验版)新建会话后,我在 AI Shell 里问:请简要介绍在 HarmonyOS 应用中调用华为云 OBS REST API 时 Header 签名的基本步骤和容易出错的地方,只做文字介绍。AI 给出的步骤以 V4 思路展开,讲规范化请求、CanonicalHeaders、SHA-256 等内容,思路完整,但与本案例实际使用的 HMAC-SHA1 方式版本不同。
这次对照得到的教训是:AI 的回答只能作为理解思路的参考,签名、Endpoint、权限等关键点要以案例文档和 OBS 官方文档为准,不能直接照抄进代码。AI DevSpace 体验版还有一点要注意:容器环境 3 小时后会释放、再次启动是全新容器,重要文档要及时保存,也不要把敏感内容留在里面。
四、下一步想试的
- 大于 64 MiB 的视频分段上传:初始化、分段、合并、失败与取消后的清理;分段 ETag 不能当整文件 MD5。
- 按 OBS 对象 lastModified 分组做云相册时间轴,并标明是备份或上传时间,而不是拍摄时间。
这篇笔记记录的是 2026 年 11 月 12 日一次真实浏览与提问的对照结果,未涉及任何真实账号密钥。案例代码仓:harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum(GitCode)。
- 点赞
- 收藏
- 关注作者
评论(0)