HarmonyOS 与 OBS 云相册:从签名上传到云端预览
在 HarmonyOS 应用中接入对象存储,能够把本地照片和视频安全地备份到云端。本文结合个人云相册案例,梳理从 OBS 请求签名、逐文件上传到云端列表与预
六、常见问题排查
如果上传返回 403,应依次检查系统时间、Endpoint、桶名、签名字符串和 IAM 权限;如果列表为空,确认对象前缀与分页参数;如果预览失败,检查内容类型、对象大小及缓存空间。开发阶段建议把请求 ID 和不含敏感信息的错误码记录下来,但不要输出 Authorization、AK/SK 或完整签名。对于网络波动,可以使用有限次数的指数退避重试,并确保重试不会生成重复对象。上线前还应验证权限拒绝、取消上传、同名文件和大文件等边界场景。
览的完整思路。
一、整体架构
应用端使用 ArkTS 与 ArkUI 构建本地图库、备份记录和云端图库三个主要界面。对象存储使用私有 OBS 桶,客户端通过 Header 签名访问,不把桶设置为公开读写。上传流程按单个文件执行,便于展示进度、取消任务并定位失败文件。
二、OBS Header 签名
发送请求前,需要根据 HTTP 方法、内容类型、日期、规范化的 OBS 请求头和资源路径组成待签名字符串,再使用 Secret Access Key 计算 HMAC-SHA1,最后生成 Authorization 请求头。Endpoint 必须使用桶所在区域的域名,设备时间也要准确,否则容易出现 403。
三、逐文件备份
读取系统相册时应先申请必要权限,只处理用户明确选择的照片或视频。每个文件上传前记录名称、大小和目标对象键;上传完成后写入本地备份记录。失败时保留明确错误信息,不应把未完成任务显示为成功。对于较大视频,还可以进一步扩展分段上传与断点续传。
四、云端浏览与预览
云端图库通过 ListObjects 接口获取对象列表,再按列表或网格形式展示。预览私有对象时同样需要认证请求,并应限制本地缓存容量和同时加载的缩略图数量,避免低内存设备出现卡顿。图片和视频加载失败时应显示可重试状态。
五、安全注意事项
AK/SK 不应写入源码、日志、截图或公开仓库。实际项目建议使用权限受限的专用 IAM 用户,仅授予目标桶所需的列举、上传和读取权限,并定期轮换访问密钥。测试时使用非敏感照片,确认对象成功上传和预览后再扩大使用范围。
通过以上设计,可以形成“本地选择—签名上传—记录状态—云端浏览—安全预览”的完整闭环,也为后续增加时间轴、文档备份和跨设备恢复打下基础。
- 点赞
- 收藏
- 关注作者
评论(0)