鸿蒙云相册案例实测:OBS Header 签名上传照片的五个步骤与三个坑
今天在鸿蒙开发实践中心完整读了“用OBS打造个人云相册app”案例,又在 AI DevSpace 体验版的 AI Shell 里就 OBS 签名上传追问了一轮,把“照片怎么从鸿蒙手机安全落到自己的 OBS 私有桶”这件事彻底理了一遍。下面是我核对过的链路和坑位,细节均来自案例文档本身,签名算法以 OBS 官方文档为准。
一、这个案例到底在做什么
一句话:一个基于 HarmonyOS 的个人云相册 App,把用户授权的本地照片和视频逐文件备份到自己的华为云 OBS 桶,并提供备份记录、云端对象列表与预览。
它有四个值得先记住的设计点:
- 备份是“逐文件、可核验”的:备份记录按 Endpoint 和桶隔离,已完成的文件依据本地记录、MD5 和云端 ETag 核验跳过;取消的当前文件需要整文件重新上传。
- 对象键有讲究:由本地 URI、大小、修改时间与 MD5 等信息生成,使用
photo_backup/v2/前缀。 - 上限要记牢:应用单文件上传和预览上限为 64 MiB;云预览磁盘缓存上限 128 MiB,缩略图最多 64 张。
- 预览走认证 GET:列表、缩略图和视频预览都是读取原对象的认证 GET,公网读取可能产生流出流量。
二、开始之前:先把四项配置准备好
App 设置页要填四项:AK、SK、区域 Endpoint、桶名。获取路径都在控制台:
- 创建私有桶:桶列表里新建,区域按实际选择,存储类别选标准存储,冗余策略单 AZ 或多 AZ 任选;桶名全局唯一,只能用小写字母、数字和连字符。桶名、区域及单/多 AZ 策略创建后不能直接改,提交前核对。
- 取得 AK/SK:控制台右上角用户名菜单进入“我的凭证 → 访问密钥 → 新增访问密钥”,按提示验证身份并下载保存密钥文件。SK 只在新建时能看到,遗失只能新建替换。
- Endpoint:桶概览里看所属区域的 Endpoint,例如华北-北京四是
obs.cn-north-4.myhuaweicloud.com,不要填成“桶名.Endpoint”形式的域名,也不要照抄别的区域的默认值。 - 权限最小化:推荐用已开启“编程访问”的专用 IAM 用户,只给该桶的
obs:bucket:ListBucket和桶内对象的obs:object:PutObject、obs:object:GetObject,范围以测试桶为限。
资源包是可选项:40 GB/1 年的标准存储包可用于抵扣存储费,但必须注意区域和单/多 AZ 策略要与桶匹配,否则无法抵扣、按需计费;不买资源包也可以按需使用。
三、五个步骤:从照片到 OBS 对象
第 1 步:准备凭证与端点
AK/SK、Endpoint、桶名、对象名四项齐全再动手。对象名建议按 photo_backup/v2/ 前缀组织,便于后续按时间或批次管理。
第 2 步:构造待签名字符串 StringToSign
Header 签名(OBS V2 风格)把请求要素按固定顺序拼成待签名串,每行用 \n 分隔,大致是:HTTP 方法(PUT)、Content-MD5、Content-Type、Date、规范化的 x-obs-* 头、规范化资源(桶名 + 对象名,含子资源时有特殊拼接规则)。
这一步只有一个要求:和官方文档逐字段对齐。差一个换行、一个空行,验签就失败。
第 3 步:计算签名
Signature = Base64(HMAC-SHA1(SK, StringToSign))
用 SK 作 HMAC 密钥,对 StringToSign 做 HMAC-SHA1,再 Base64 编码。注意 V2 用 SHA1;如果走 V4,签名密钥要从 SK 按 Date/Region/Service 逐级派生,流程更复杂,别把两套混用。先确认桶和区域要求哪一套。
第 4 步:组装请求头并发起 PUT
在 ArkTS 里用 @ohos.net.http 发 PUT 请求,关键头:
| 头字段 | 值 |
|---|---|
| Authorization | OBS <AK>:<Signature> |
| Date | 与签名时用的完全一致 |
| Content-Type | image/jpeg 等 |
| Content-MD5 | 签名时包含了,请求里也必须带,且值一致 |
| x-obs-* | 签名时包含的每个自定义头,请求里都要原样带上 |
请求体就是照片的二进制数据(ArrayBuffer / 文件流)。
第 5 步:处理响应
200 OK:上传成功,响应头里的 ETag 就是对象的 MD5,可用来和本地记录核对、做去重。403 Forbidden:签名错误或时间偏移,看响应体里的 Code / Message 定位,先核对四项配置、设备时间、权限与规范化资源。
四、三个最容易踩的坑
坑 1:把 AK/SK 写进 App
永久 AK/SK 打进客户端,等于把桶的完整读写权限交给所有用户,反编译即可提取。案例文档也明确提醒:设置页的 AK/SK 虽然是密码态输入,但仍以明文保存在应用沙箱 preferences 中,仅用于教学调试。正确做法是最小权限的专用 IAM 用户,生产应用应采用临时授权方案;AK/SK 只在 App 中填写,不发到聊天、源码或截图中。
坑 2:签名串与请求头“差一点”
最常见的 403 都来自不一致:StringToSign 里写了某个头,请求里没带;Date 用了请求发出时的新时间,而不是签名时的时间;设备时间本身偏移过大。排查时逐项比对:签名串的每一行、每一个参与签名的头、Date、Endpoint、桶名。
坑 3:费用与配额按“匹配”结算
存储包只按适用条件抵扣存储费,公网下载流量、读写请求以及超出额度或有效期的用量仍可能产生费用;资源包、桶的区域与 AZ 策略、对象的存储类别必须匹配,才可抵扣相应费用。40 GB 是存储容量额度,不是下载流量,也不是整年费用封顶。云工作区和云手机也可能消耗配额或费用。
五、完成标志与清理
按案例的验收标准,准备完成的标志是:桶在控制台可见,已取得四项配置;App 安装后按设置页保存配置并检查连接,测试照片备份成功且云端可找到对应对象。
用完记得清理:保存需要的工程及数据,停止不再使用的云工作区和设备;核对后删除测试对象及不再需要的桶,撤销或轮换测试密钥。桶启用版本管理时,删除当前对象不一定删除历史版本,要按控制台实际版本清理并确认费用。
实践来源:鸿蒙开发实践中心“用OBS打造个人云相册app”案例(文档 v1.1.3,2026-11-07),及 AI DevSpace 体验版 AI Shell 的问答核对。签名算法细节请以 OBS 官方文档为准。
- 点赞
- 收藏
- 关注作者
评论(0)