鸿蒙应用接入华为云 OBS:Header 签名直传与上传可靠性实践
做相册类鸿蒙应用时,一个绕不开的问题是:用户选了几十个照片视频,怎么把它们安全、稳定地送到云端。走自建服务中转,带宽和存储成本都在自己身上;直接让客户端连 OBS,又要解决“密钥不能下发到端上”这个死结。最近把这条链路完整跑了一遍,记录几个关键决定。
一、为什么选 Header 签名直传
最省事的做法是把 AK/SK 写进应用里,客户端自己算签名。这在演示环境没问题,上线就是事故:反编译拿到密钥,整个桶就归别人了。更稳妥的做法是让服务端用临时凭证(STS)签发短期 Token,或者直接由服务端生成一次性的签名,客户端只负责按签名发请求。前者的好处是客户端还能列对象、断点续传;后者更轻,适合只需要上传的场景。相册备份属于前者——用户可能随时翻看云端列表,所以最终选了 STS + Header 签名。
二、签名串到底怎么拼
OBS 的 Header 签名遵循一套固定格式,签名前的待签字符串由五行组成:HTTP 方法、Content-MD5、Content-Type、Date,加上 CanonicalizedHeaders 与 CanonicalizedResource 拼成的两段。这里最容易出错的是 CanonicalizedResource,它必须精确到对象键,形如 /桶名/对象键,且对象键里的特殊字符要按规则编码,少一个斜杠签名就对不上。
真正下手时建议先写一个最小可用的签名函数,用 curl 或 Postman 验证通过,再搬到端上。因为一旦在客户端调试,报错只会给你一句 403 SignatureDoesNotMatch,看不出是 Date 过期、Content-Type 不一致,还是资源路径拼错。
三、端上的上传链路
鸿蒙侧用 request 模块的文件上传能力逐文件提交,配一个本地任务表记录每个文件的状态:等待、上传中、成功、失败、待重试。列表页读任务表渲染进度,天然支持“后台继续传”。这里有两个细节值得强调:
第一,串行优于并发。手机上行带宽有限,开五个并发上传只会让每个请求都变慢,还容易触发服务端限流。实际做法是并发度设为 1 到 2,大文件走分片。
第二,对象键要幂等。不要用自增 ID 或时间戳做对象名,改用“用户 ID + 文件内容摘要 + 扩展名”。这样同一张照片重复上传不会产生副本,重试也不会污染桶。
四、失败与恢复
移动端网络切换频繁,失败是常态而不是异常。重试要有上限和退避,超过三次标记为失败并允许用户手动重试。大文件用分片上传(initiate / uploadPart / complete),分片号与 ETag 保存在任务表里,应用被杀掉后重新拉起,可以从已完成的分片继续,而不是从头再来。
另外,上传失败时最好把响应体里的错误码落库。OBS 的错误码区分度很高:NoSuchBucket 是桶名写错,AccessDenied 是策略问题,RequestTimeTooSkewed 是手机时间偏差超过允许范围。带着错误码排查,比盯着一个“上传失败”的提示高效得多。
五、安全上的几条底线
桶策略按最小权限收敛,只给当前用户前缀下的读写;STS 有效期压到小时级;关闭公共读,预览一律走带过期时间的签名 URL;服务端日志里不要打印完整签名串和临时凭证。这几条看起来琐碎,但任何一条漏掉,前面做的所有努力都会被抹平。
整套链路做完,最深的体会是:客户端直传的价值不在于少写几行代码,而在于把一个“带宽成本 + 密钥暴露”的双重风险,换成了“签名正确性 + 失败可恢复”的工程问题。前者是花钱,后者是耐心,而耐心是可以靠设计和测试积累的。
- 点赞
- 收藏
- 关注作者
评论(0)