从一次 403 到可重试:鸿蒙云相册接入 OBS 的四个工程化细节
问题不是“能不能上传”,而是“失败后还敢不敢重试”
在鸿蒙端实现个人云相册时,把照片传到华为云 OBS 看似只有一步 PUT,真正进入可用阶段后,问题会迅速变成:签名为什么偶发失效、同一张照片会不会传两遍、网络中断后应该重试还是提示用户、出问题时能不能只凭日志定位到具体对象。最近我围绕这些边界重新梳理了一套实现思路,核心不是增加更多按钮,而是把上传链路拆成可以验证的四个部分。
一、把签名边界说清楚
OBS 请求签名依赖请求方法、关键请求头、规范化资源和时间。工程里最容易忽略的不是算法,而是“签名前后请求必须完全一致”:先签名再随意补 Content-Type、修改查询参数,或者在代理层改写 Host,都可能得到 403。我的做法是把请求构造收敛到一个函数:先生成最终 URL、对象键和必要请求头,再计算签名,之后只允许网络层发送,不允许业务层二次改包。Endpoint 也必须经过校验,只接受当前桶对应地域的域名,避免配置误填后把请求发到错误区域。
另一个边界是凭据。客户端不应假设长期密钥是安全的;更合理的方案是使用最小权限身份或短期凭证,并确保授权范围只覆盖目标桶所需操作。调试日志中只记录桶名、对象键摘要、状态码和请求编号,不记录 Authorization、临时密钥或完整签名串。这样既能排障,也不会把敏感信息带进日志。
二、幂等键要在上传前生成
相册备份常见的重复来自三种情况:用户连点两次、失败后重试、应用重启后恢复任务。如果对象键每次随机生成,云端就会出现多份相同文件。更稳妥的方式是在上传前用“本地 URI、文件大小、修改时间、文件内容摘要”生成稳定对象键,再按 Endpoint 和桶做隔离。只要输入不变,重试就落到同一个对象键上,上传操作自然具备可重复执行的基础。
仅有固定对象键还不够。上传前应先查询本地记录;对状态未知的任务执行 HEAD 校验,比对对象是否存在、长度是否符合预期,再决定跳过还是重新 PUT。每条记录至少包含 PENDING、UPLOADING、DONE、FAILED 四种状态,并把“已成功”和“待确认”分开。这样应用崩溃后不需要全量重传,也不会把一次未完成的请求误判为成功。
三、失败要分级,而不是统一“再试一次”
网络断开、服务端 5xx、请求超时通常适合有限重试;可以采用指数退避并加入随机抖动,避免大量客户端在同一时刻再次冲击服务。403 往往意味着签名、时间、权限或桶配置有问题,继续盲目重试只会放大错误;404 要检查桶和对象键;文件过大则应在上传前拦截。对 408、429 这类临时状态可以单独处理,但仍要设置最大次数和总时长。
用户界面也应体现分级:配置错误直接提示检查哪一项,网络错误显示可恢复的“继续备份”,单文件失败不应中断其余文件。任务以文件为单位推进,比“整个相册成功或失败”更符合移动端弱网场景。
四、可观测性要服务于定位
一条有价值的日志至少应回答:哪个对象键、第几次尝试、耗时多久、返回什么状态、归类为哪种错误。对象键或用户标识可以在客户端做摘要,避免日志中直接暴露隐私路径。一次请求结束后记录开始时间、响应时间和结果,再把这些字段汇总到备份记录页,用户和开发者看到的是同一套事实。
最后可以用一份很短的清单做回归:修改 Endpoint 后是否仍指向正确地域;重复点击是否只生成一个对象;上传中断后能否从记录恢复;403 是否被识别为配置问题;成功对象再次备份能否直接跳过;日志里是否完全没有凭据和签名。把这些检查做成固定流程后,云相册的上传体验才会从“这次碰巧成功”变成“失败也可控”。
- 点赞
- 收藏
- 关注作者
评论(0)