鸿蒙 + 华为云 OBS 云相册案例实战：从案例浏览到跑通的完整记录

一、案例背景

「云相册」是鸿蒙开发实践中心里一个很典型的端云协同案例：客户端用 ArkTS/ArkUI 写 HarmonyOS 应用，云端用华为云对象存储 OBS 存放图片，配合预签名 URL 做上传与预览。整个案例的价值在于把「移动端 + 对象存储 + 权限签名」这条最容易踩坑的链路完整走了一遍。

二、动手前的三个准备

1. OBS 桶：创建标准存储桶，地域与后续 endpoint 保持一致，权限先设为私有，避免出现「能传不能读」的错觉。

2. 访问密钥：用 IAM 子账号创建 AK/SK，并只授予该桶的读写权限。生产环境切记不要把 AK/SK 硬编码进客户端，正确做法是由后端签发临时凭证或预签名 URL。

3. 开发环境：DevEco Studio + HarmonyOS SDK，模拟器或真机任选。签名配置不对会导致安装失败，但报错信息通常很含糊，建议先在模板工程上跑通一次空应用再替换代码。

三、关键实现思路

• 上传：客户端只负责把图片读成 ArrayBuffer，通过预签名 URL 以 PUT 方式直传 OBS，避免流量绕行服务端。
• 列表：对象名前缀 + 分页标记（marker）拉取，返回的 key 直接拼成访问地址；私有桶需要每次带签名。
• 预览：图片体积大时先取缩略图参数（x-image-process），首屏加载速度提升非常明显。
• 删除与回收：删除是幂等操作，建议在客户端做二次确认，避免误删后无法恢复。

四、实际踩到的坑

坑 1：签名过期。预签名 URL 默认有效期较短，缓存到列表里再点开经常 403。解决方式是把有效期拉到业务可接受的上限，或在点击时实时换取。

坑 2：跨域与 Content-Type。直传时如果 Content-Type 与实际文件不一致，浏览器/客户端可能被拒；上传前统一按扩展名映射 MIME 类型最稳妥。

坑 3：中文对象名。对象 key 里带中文或空格会导致 URL 编码混乱，建议统一用「时间戳 + 短哈希」命名，展示名另存数据库。

坑 4：并发上传顺序。多图同时上传时，完成顺序不可预期，列表需要用本地临时占位 + 状态位管理，否则会出现「图片错位」。

五、把开发环境也搬到云上

这次顺手体验了华为云 AI 开发者空间的体验版：进入后是一个带 AI Shell 的云端工作区，可以直接用自然语言让它生成 IaC 模板、起 ECS、配 OBS，省掉了本地装工具链的时间。对于只想快速验证一个端云方案的场景，这种「打开浏览器就能写代码」的方式确实比本地搭环境轻。

需要提醒的是体验版容器会在几小时后释放，代码和数据要及时提交到代码仓或下载到本地，别把实验成果留在临时容器里。

六、小结

这个案例本身代码量不大，但把对象存储的鉴权模型、预签名直传、缩略图处理这几个要点都串起来了。做完一遍之后再回头看文档，很多之前觉得绕的概念会变得清晰。建议按「先跑通 → 再改参数 → 最后替换成自己的业务字段」的节奏推进，比一上来就魔改工程效率高得多。