鸿蒙云相册案例实测:OBS Header 签名上传照片的五个步骤与三个坑

举报
yd_291742659 发表于 2026/11/07 13:46:44 2026/11/07
【摘要】 今天读了鸿蒙开发实践中心“用OBS打造个人云相册app”案例,并在 AI DevSpace 里核对了 OBS Header 签名上传的流程,整理出从准备四项配置、构造签名串、计算签名、发起 PUT 到处理响应的五个步骤,以及 AK/SK 安全、签名一致性、费用匹配三个坑。

今天在鸿蒙开发实践中心完整读了“用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、桶名。获取路径都在控制台:

  1. 创建私有桶:桶列表里新建,区域按实际选择,存储类别选标准存储,冗余策略单 AZ 或多 AZ 任选;桶名全局唯一,只能用小写字母、数字和连字符。桶名、区域及单/多 AZ 策略创建后不能直接改,提交前核对。
  2. 取得 AK/SK:控制台右上角用户名菜单进入“我的凭证 → 访问密钥 → 新增访问密钥”,按提示验证身份并下载保存密钥文件。SK 只在新建时能看到,遗失只能新建替换。
  3. Endpoint:桶概览里看所属区域的 Endpoint,例如华北-北京四是 obs.cn-north-4.myhuaweicloud.com,不要填成“桶名.Endpoint”形式的域名,也不要照抄别的区域的默认值。
  4. 权限最小化:推荐用已开启“编程访问”的专用 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 官方文档为准。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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