鸿蒙云相册学习笔记:用 OBS Header 签名实现 ArkTS 照片上传,并用 AI DevSpace 排查 403

举报
yd_224048907 发表于 2026/11/13 00:34:49 2026/11/13
【摘要】 一、前言:今天学了什么,为什么写这篇笔记今天我在鸿蒙开发实践中心浏览了一个很有代表性的案例:用对象存储服务 OBS 打造个人云相册应用。案例的思路很直观,手机端用 HarmonyOS 的 ArkTS 写一个相册应用,照片不再只存在本地,而是上传到云端对象存储,换手机、换设备也能随时查看、下载和分享。这个想法几乎每个做过手机应用的人都想过,但真正动手时,第一个拦路虎不是界面,而是上传接口的鉴权...

一、前言:今天学了什么,为什么写这篇笔记今天我在鸿蒙开发实践中心浏览了一个很有代表性的案例:用对象存储服务 OBS 打造个人云相册应用。案例的思路很直观,手机端用 HarmonyOS 的 ArkTS 写一个相册应用,照片不再只存在本地,而是上传到云端对象存储,换手机、换设备也能随时查看、下载和分享。这个想法几乎每个做过手机应用的人都想过,但真正动手时,第一个拦路虎不是界面,而是上传接口的鉴权:OBS 的 Header 签名到底怎么算,签名串里哪些头要参与,顺序错了会怎样,返回 403 又该从哪里查。为了把这个问题彻底弄明白,我没有只看案例说明,而是接着在 AI DevSpace 体验版里新开了一个 AI 对话会话,向 AI Shell 提了一个真实的技术问题,问的是 ArkTS 里如何用 HMAC-SHA1 实现 OBS Header 签名上传照片,签名串如何构造,Authorization 头怎么写,上传返回 403 SignatureDoesNotMatch 时如何排查。AI 给出了完整的回答,包括签名公式、规范化规则、ArkTS 代码要点和八步排查清单。这篇笔记就是把案例浏览、代码仓 Star、AI 对话这三件事串起来的一次学习记录:先讲案例本身,再讲签名原理,再讲 ArkTS 落地,最后讲排查方法,希望对同样在学 HarmonyOS 端云协同的开发者有一点参考价值。二、案例速览:OBS 个人云相册是怎么做的。这个案例的目标是做一个个人云相册应用。用户在手机上选一张本地照片,应用把照片上传到 OBS 桶里,同时在界面上展示已上传照片的列表,支持查看原图、删除和分享。案例把功能拆得很清楚:前端是 HarmonyOS 应用,负责选图、展示列表、调用上传接口;后端存储是 OBS,负责保存照片原文件;中间没有再搭一个自己的业务服务器,上传鉴权直接用 OBS 的 Header 签名方式完成。案例的页面结构也值得学习。首页是相册列表,用网格展示缩略图;点开一张照片进入详情页,可以查看大图和拍摄时间等信息;右下角有一个上传按钮,点击后打开系统图片选择器,选图后立即开始上传,上传过程中显示进度,完成后列表自动刷新。这种先有列表、再有详情、最后补上传的拆分方式,比一上来就写上传逻辑要稳妥得多,因为列表和详情可以先用本地假数据跑通,再把云端接口接进来。案例还提到了几个容易被新手忽略的点。第一是桶和对象的概念:桶相当于一个顶层容器,照片以对象的形式存在桶里,对象名就是照片在桶里的路径加文件名,设计对象名时最好按日期或者用户来分目录,避免所有照片堆在一个目录下。第二是访问控制:上传用的桶不能完全公开写,否则任何人都能往里面写文件;读取照片时则要根据分享需求决定是走签名链接还是走公开读。第三是成本意识:照片原图一般比较大,上传前可以先在端侧做一次压缩或者生成缩略图,列表页只加载缩略图,详情页再加载原图,这样流量和加载时间都会好很多。三、核心难点:为什么上传要用 Header 签名。很多初学者第一次接触 OBS 上传时,第一反应是直接把文件发过去就行,为什么还要算签名。其实原因很简单:对象存储是一个公开可访问的云服务,如果不做鉴权,任何人拿到桶地址就能上传和删除文件,数据安全完全没有保障。OBS 的做法是每一次上传请求都要带上签名,服务端收到请求后用同样的算法重新算一遍签名,比对一致才放行,不一致就返回 403。Header 签名方式的特点是把签名放在请求头里,而不是放在地址栏里。它的优点是地址干净,不会在地址里暴露签名参数;缺点是签名串的构造规则比较严格,参与签名的请求头、请求方法、资源路径、日期,任何一个细节对不上,签名就会算错。案例里用的就是这种方式:客户端在发起上传请求前,先用自己的访问密钥算出签名,再把签名放到 Authorization 请求头里发出去。这里有一个关键概念要分清:访问密钥由两部分组成,一个是可以公开的访问密钥标识,一个是必须保密的秘密访问密钥。签名算法用秘密访问密钥对一段待签名字符串做 HMAC-SHA1 运算,再做 Base64 编码,得到的就是签名。服务端用同样的秘密访问密钥和同样的待签名字符串重新计算,如果两个签名相同,就说明请求确实来自持有该密钥的人,而且请求内容在传输过程中没有被篡改。四、签名串是怎么构造的:StringToSign 的每一行都不能错。AI DevSpace 的回答把签名串的构造讲得很清楚,我在这里结合案例复述一遍。待签名字符串一般由六行组成,每行之间用换行符连接:第一行是 HTTP 请求方法,例如 PUT;第二行是 Content-MD5,如果没有就留空;第三行是 Content-Type,例如 image/jpeg;第四行是 Date,也就是请求时间,格式必须是格林威治标准时间;第五行是规范化后的请求头;第六行是规范化后的资源。规范化请求头是新手最容易出错的地方。只有以特定前缀开头的自定义请求头才需要参与签名,而且要把请求头的名字全部转成小写,按字典顺序排序,名字和值之间用冒号连接,值的前后空格要去掉,多个值之间用逗号连接。如果这一步的排序或者空格处理错了,服务端算出来的签名就会和客户端不一样。规范化资源也有讲究。资源部分要写成斜杠加桶名加对象名的形式,如果请求里带有子资源参数,例如与访问控制相关的参数,也要按规则拼到资源后面。对象名里如果有中文或者特殊字符,要先做统一的编码处理,上传时用的对象名和签名时用的对象名必须完全一致,否则签名一定对不上。最后的 Authorization 请求头格式是固定的:先写一个标识词,再写一个空格,再写访问密钥标识,再写一个冒号,再写签名。很多人第一次写的时候会把冒号写成中文冒号,或者在标识词后面多加空格,这些小错误都会导致 403。建议第一次调试时,先把待签名字符串完整打印出来,一行一行核对,再和服务端报错里提示的期望签名串做对比。五、ArkTS 落地:从选图到上传的完整链路。把签名原理落到 ArkTS 代码里,大致可以分成五个步骤。第一步是选图,调用系统图片选择器拿到用户选中的照片路径,同时申请好读取媒体文件的权限。第二步是读文件,把照片文件读成字节数组,准备作为请求体发送。第三步是算签名,用密码学框架提供的 HMAC 功能,以秘密访问密钥为密钥,对待签名字符串做 HMAC-SHA1 运算,再做 Base64 编码,得到签名字符串。第四步是发请求,用网络请求模块发起 PUT 请求,把照片字节作为请求体,把 Authorization、Date、Content-Type 等请求头一起带上。第五步是处理返回,上传成功一般返回状态码 200,失败则根据返回的错误码做不同的提示。这里有几个实践细节。第一是时间问题,签名里的 Date 必须和服务端时间基本一致,如果手机时间偏差太大,签名会因为过期而失败,调试时先检查手机时间是否准确。第二是 Content-Type 要前后一致,签名时用的类型和实际请求头里的类型必须是同一个值,不能一个写 image/jpeg,另一个写 application/octet-stream。第三是请求头的自动处理,有些网络请求库会自动补上一些请求头,这些自动补上的头如果参与了签名,就会导致不一致,写代码时要明确知道库会自动加哪些头。第四是文件读取方式,大照片不要一次性全部读进内存再上传,条件允许时可以分段读取或者先压缩,避免内存占用过高导致应用闪退。六、AI DevSpace 对话实录:我问了什么,AI 答了什么。今天的 AI DevSpace 体验是在免费体验版里完成的,没有消耗核时。进入体验版后,我新开了一个 AI 对话会话,会话标题由系统自动生成为 HarmonyOS ArkTS OBS 签名上传与 403 排查。我提的问题是:在 HarmonyOS ArkTS 应用中,如何用 HMAC-SHA1 实现华为云 OBS Header 签名上传照片,请说明签名串的构造方法、需要规范化的请求头和资源、Authorization 请求头的格式,以及上传返回 403 SignatureDoesNotMatch 时的排查步骤。AI 的回答分成了几个部分:先给签名公式,再讲待签名字符串的六行结构,再讲规范化请求头和规范化资源的规则,再讲 Authorization 请求头的格式,再给出 ArkTS 的实现要点,包括密码学框架的用法和网络请求模块的用法,最后给出 403 的八步排查清单。回答里还提醒了一个 ArkTS 里的坑:网络请求模块可能会自动添加某些请求头,如果这些头被自动加上了,但签名时没有算进去,就会导致签名不一致。这次对话还有一个小插曲:AI 在思考过程中尝试联网搜索时提示无密钥搜索达到每日上限,但这没有影响回答本身,AI 继续用已有知识完成了完整回答。对话结束后,我点了体验版顶部的释放按钮,确认释放后容器被关闭,页面回到了开发者官网首页。整个过程没有出现同步临时访问凭据到 AI Shell 的协议弹窗,所以也不存在需要停下来请示的情况。七、403 SignatureDoesNotMatch 八步排查清单。如果上传时遇到 403,并且错误码是签名不匹配,可以按下面这个顺序排查。第一步,核对访问密钥标识和秘密访问密钥是否写错,特别注意复制时多带了空格或者换行。第二步,核对请求方法,上传用 PUT 还是 POST,签名时用的方法必须和实际发出去的方法一致。第三步,核对 Content-Type,签名时和实际请求头里的类型要完全一致。第四步,核对 Date,检查手机或者服务器时间是否准确,时间格式是否符合要求。第五步,核对规范化请求头,检查参与签名的头是否按字典顺序排序,名字是否全部小写,值的前后空格是否去掉。第六步,核对规范化资源,检查桶名、对象名和子资源参数是否完整,对象名编码是否一致。第七步,核对 Authorization 请求头的格式,检查标识词、空格、冒号、访问密钥标识和签名的顺序是否正确。第八步,把客户端算出的待签名字符串完整打印出来,和服务端返回的期望签名串逐行对比,差异往往就在某一行。这个清单的价值在于它把一个看似神秘的 403 变成了一个可以逐项打勾的检查表。以前遇到 403 只能凭感觉改代码,现在可以先打印待签名字符串,再按清单逐项排除,大部分问题在前三步就能定位。建议把这个清单保存下来,下次做对象存储上传时直接照着查。八、对比学习:单词打卡案例的端云一体化是另一条路。今天除了 OBS 云相册案例,我还顺手看了一个单词打卡学习案例。这个案例的思路和云相册完全不同,它用的是端云一体化方案,手机端负责界面和打卡交互,云端用后端服务来保存单词和打卡记录,开发者不需要自己写签名和上传逻辑,调用云端接口就能完成数据的增删改查。两种方案各有适用场景。OBS 直传方案适合照片、视频这种大文件,文件直接从手机传到对象存储,不经过自己的服务器,速度快,成本低,但鉴权逻辑要自己处理。端云一体化方案适合单词、打卡记录这种结构化小数据,开发速度快,不用操心鉴权细节,但大文件存储不是它的强项。理解了这个区别,以后做新项目时就能更快选对技术路线:有大量文件要存,就优先考虑对象存储直传;主要是结构化数据和小文件,就优先考虑端云一体化。我今天还给单词打卡案例的代码仓点了一个 Star。这个仓之前还没有 Star,点之前显示 734,点之后变成 735,按钮也变成了已 Star 状态。而 OBS 云相册案例的代码仓之前已经是已 Star 状态,显示 1001,我就没有再点,因为再点一次会取消 Star。这也提醒我,做每日 Star 任务时一定要先核对状态,已 Star 的不要重复点。九、复盘与改进:这篇笔记之后还可以做什么。复盘今天的学习,收获最大的是把签名原理和 ArkTS 实现对应了起来。以前看文档时,签名串的六行结构只是一个抽象的定义,今天通过 AI 对话和案例对照,才真正理解每一行是干什么的,以及哪一行最容易错。不足之处是今天只做了原理学习和对话验证,还没有真正把上传代码跑起来,下一步应该在开发环境里写一个最小可用的上传示例,先上传一张小图片,再逐步加上进度显示、失败重试和断点续传。安全方面也有改进空间。把秘密访问密钥直接写在手机应用里是不安全的做法,反编译后密钥容易泄露。更稳妥的做法是让应用先向自己的业务服务器申请一个临时签名或者临时凭证,再用这个临时凭证去上传,密钥本身不离开服务器。案例里为了教学简单用了直接签名的方式,真实项目里一定要加上这一层。另外还可以做的改进包括:上传前在端侧生成缩略图,列表页只加载缩略图;上传失败时自动重试一次,并给用户明确的错误提示;给照片对象名加上日期目录,方便按时间浏览和清理;定期检查桶的访问控制,避免因为配置失误导致照片被未授权访问。十、总结。今天的学习围绕一个很具体的目标展开:把鸿蒙云相册案例里的 OBS 上传真正弄懂。从浏览案例详情页超过 30 秒开始,到核对代码仓 Star 状态,再到在 AI DevSpace 里提问并收到完整回答,每一步都有明确的产出。这篇笔记把签名公式、签名串构造、规范化规则、ArkTS 实现步骤和 403 排查清单都记录了下来,既是今天的学习总结,也是下次做端云上传时的备查手册。如果你也在学 HarmonyOS 开发,建议按这个顺序走一遍:先找一个感兴趣的案例认真浏览,再把案例里最难的那个技术点单独拎出来问 AI,最后把问答结果整理成自己的笔记。案例、对话和笔记这三件事加在一起,比只看文档记得更牢,也更容易在真实项目里用得上。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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