鸿蒙记账本案例学习笔记:金额校验与分类统计为什么要收口到云函数

举报
yd_293248861 发表于 2026/11/19 01:11:36 2026/11/19
【摘要】 今天在鸿蒙开发实践中心浏览的案例是「个人记账本:鸿蒙端云一体记账与云端聚合统计」(仓库 HarmonyOS-APP-account-book,案例版本 v1.0.0,最后验证于 2026-08-19)。这篇笔记记录我读完案例后,对其中网络请求与数据管理分工的理解。先说明:今天我只做了案例浏览和阅读,还没有实际部署这套环境,文中事实均来自案例文档本身;最后一段的问答,是我在 AI DevSpa...

今天在鸿蒙开发实践中心浏览的案例是「个人记账本:鸿蒙端云一体记账与云端聚合统计」(仓库 HarmonyOS-APP-account-book,案例版本 v1.0.0,最后验证于 2026-08-19)。这篇笔记记录我读完案例后,对其中网络请求与数据管理分工的理解。先说明:今天我只做了案例浏览和阅读,还没有实际部署这套环境,文中事实均来自案例文档本身;最后一段的问答,是我在 AI DevSpace 里向 AI Shell 提问后得到的思路印证,我把它标出来了,不把它当作案例原文。

一、这个案例长什么样

端侧用 ArkTS 开发记账 App,有记账、明细、统计三个 Tab;云侧是部署在华为云 ECS 上的自托管 Appwrite 1.9,提供数据库、认证与云函数。案例的完整闭环是「记账 → 明细分页 → 云端聚合分类占比统计」,配套 6 个 node-16 零依赖的云函数:注册、登录、新增账目、查询账目、删除账目、分类统计(register / login / add-transaction / list-transactions / delete-transaction / get-stats)。数据放在 account_book_db 文档库的 users 和 transactions 两个集合里。案例给出的验证环境是 compile API 24、兼容 HarmonyOS 6.1.0(API 23),Appwrite 1.9.0,部署脚本自带的 verify-api.mjs 有 19 项检查。

二、端侧只做展示和交互,不直接碰数据库

端侧调云函数的路径是固定的:向 POST /v1/functions/{fnId}/executions 发请求,带上公开的 X-Appwrite-Project 头,把业务参数 JSON 字符串放在请求体里,等云函数同步返回结果。端侧的登录态用 Preferences 做本地持久化,注册登录成功后下次启动自动进入主页。

这个分工我觉得是全文最值得抄的一点:端侧的职责收敛到「收集输入、展示结果、记住登录态」,所有「这条数据能不能写、这组数字怎么算」的问题都不在端侧回答。这样做的好处是端侧代码变薄,换页面、换交互方式都不会动到业务规则。

三、金额校验为什么收口到云函数

记一笔账时,端侧把分类、金额、备注发给 add-transaction 云函数,由云函数校验金额、分类和账目归属,校验通过才写入 transactions 集合。端侧当然也可以先做一层校验,给用户即时提示,但那只能算体验层:任何绕过界面的写入路径都会让端侧校验失效。

案例还在认证上给了我一个具体的例子:密码用 node:crypto 的 scrypt 做加盐哈希,格式是 scrypt$N$salt$hash,比对时用 timingSafeEqual 做常量时间比较,目的是不让调用方通过响应耗时猜测密码。密码本身不落明文。也就是说,案例把「可信」这件事从头到尾都放在云函数这一侧,而不是依赖端侧自觉。

四、分页和超时:网络请求里最容易踩的两个细节

明细页不是一次拉全量,而是分页:list-transactions 用 page / pageSize 做偏移分页,案例文档提醒单次查询有 limit 100 的上限。统计页切换月份时,get-stats 云函数在云端按 user_id 加月份拉取当月全部记录再聚合,返回分类占比,占比之和为 100%,端侧只负责把结果画成环形图。

超时参数案例也写得很具体:端侧连接超时 10000 毫秒、读取超时 30000 毫秒,云函数超时设 30 秒;因为云函数首次调用有冷启动,案例实测约 1.5 秒,端侧要有重试策略。另外还有一个容易忽略的点:云函数执行接口返回 201,响应包外面还有一层 responseBody,需要解包才能拿到业务数据,端侧的 HttpUtil 就是按这个约定处理的。

五、分类占比聚合为什么也在云端算

「分类占比」是对用户当月全部账单做分组求和再算比例。端侧在任何时刻都只有局部数据——明细是分页加载的,还可能有离线缓存、多设备不同步的问题——拿局部数据算占比,结果必然不准。云函数直接在数据库侧对全量做聚合,任何设备、任何时刻拿到的都是同一份结果。这也是案例里说的「计算向数据靠拢」:与其把全量账单拉到端侧再算,不如让云端算好只返回结果,省流量也省延迟。

记账本分了餐饮、交通、购物、娱乐、居住、医疗、其他 7 类,统计页用 Canvas 画环形图,案例说色板用的是经过校验的 7 槽浅色分类色板,对色盲、色弱友好。

六、密钥放哪里,是另一条不能越的线

案例对敏感信息的存放位置分得很清:服务端 API key 只放在 harmony_cloud/.env 里(已加入 .gitignore),端侧 rawfile/app.config.json 里只放公开的 endpoint 和 projectId。截图、日志和演示数据在发布前要脱敏。

同时案例也坦白了演示配置的边界:云函数 execute 设为 any、配合公开项目 ID、走 HTTP,这些只适合演示环境;生产要收紧集合权限、收紧函数执行入口、接 Appwrite 原生 Auth 或 JWT、走 HTTPS 并加自有域名、给 API key 最小权限并定期轮换、再加上限流与审计。案例第 6 章把这 6 项列成「从演示到生产的最小改造清单」,我觉得这是新手最容易跳过、也最不该跳过的一章。

七、我在 AI DevSpace 里验证了这个理解

读完案例后,我在 AI DevSpace 的 AI Shell 里问了同一个问题:为什么金额校验和分类占比聚合要收口到云函数而不是放在端侧 ArkTS 里。AI 给出的三点和我的理解一致:校验放云端是单一可信源、防端侧绕过;聚合放云端是算全量、端侧只有局部视图;统一收口意味着业务规则只有一个版本,改一处就全端生效,也便于审计。它的总结是「端侧做体验,云函数做契约」,我觉得这句话可以作为这篇笔记的收尾。

小结与下一步

这篇笔记的收获可以收成三句话:端侧做体验,云函数做契约;密钥只放云侧,端侧只带公开标识;演示配置不等于生产配置,上线前按改造清单逐项收紧。

下一步我想按案例的验收表,在模拟器上跑通一轮端云联调:注册账号、登录、记 7 笔支出覆盖 6 个分类、看明细分页、切换月份看分类占比环形图,再删一笔确认列表与统计同步移除;之后再试试案例提到的扩展方向,把 get-stats 扩展为按月汇总报表下钻。等跑通了再写一篇实操笔记。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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