从一个待办清单看懂鸿蒙端云一体:FunctionGraph、APIG 与 RDS 如何分工
今天在鸿蒙开发实践中心细读了“云同步待办清单”案例,又在 AI DevSpace 里向 AI Shell 请教了 FunctionGraph 的适用场景,两边的收获串起来,刚好能讲清楚一个问题:一个看起来很简单的待办清单 App,为什么要用 FunctionGraph、APIG、RDS 三件套?每一层到底在干什么?
一、整体架构:端侧很薄,云端很厚
一句话概括:端侧只负责展示和交互,业务规则与数据全部收口在云端。
- 端侧:HarmonyOS ArkTS 应用,只有登录页和清单页,负责登录态持久化、任务列表渲染和 30 秒一次的轮询同步。
- 入口:APIG 专享版,系统唯一的公网入口,负责认证、限流与转发,所有请求统一带 /todo 前缀。
- 云侧:FunctionGraph 云函数共 8 个,承担注册登录、任务增删改查、云同步、建表初始化和诊断。
- 数据:RDS for MySQL,users、sessions、tasks 三张表,函数与数据库挂同一 VPC,通过内网 3306 端口互访,数据库不暴露公网。
换一台设备登录同一账号,任务 30 秒内自动同步一致,因为两台设备读的是同一份云端数据。
二、一次登录,请求走了哪些地方
App 把账号密码发给 APIG,APIG 转发给 login 云函数;函数在 VPC 内校验数据库里的账号密码哈希,通过后签发 token,再原路返回。端侧保存 token,后续请求都带上它。
三个值得新手注意的细节:第一,业务接口统一返回 {“code”:0,“message”:“ok”,“data”:{…}},code 为 0 成功、1 业务错误、2 未登录或会话失效,端侧按 code 分支处理即可。第二,密码用 scrypt 加盐哈希加 timingSafeEqual 校验,不存在的邮箱也要执行等代价哈希,避免用响应时间反推邮箱是否存在。第三,注册只建账号不签发 token,不留下用不上的孤儿会话。
三、云函数基线:三个容易踩的坑
第一,APIG 转发的 body 是 base64 编码的,函数里必须先解码再解析,否则会报 JSON 解析错误。第二,mysql2 默认把时间转 UTC,案例用 dateStrings:true 加 getBeijingTime() 对齐北京时间,不然截止时间会差 8 小时。第三,写操作要做幂等 upsert,重复提交不会产生重复任务;冷启动首次调用可能 504,端侧内置 3 次重试,超时先重试,别急着改代码。
四、在 AI DevSpace 里验证的结论
我在 AI DevSpace 新建会话问了 FunctionGraph 适合什么场景,得到的回答和案例的选型完全对得上:它是事件触发、按执行时长计费的 Serverless 服务,最适合事件驱动型数据处理(如上传图片后自动生成缩略图)和定时任务(如每天凌晨巡检、清理日志),共同点是“有事才跑,跑完就歇”。待办清单的请求正是离散的、事件驱动的,平时几乎没有流量,用 Serverless 承接比常驻服务器更贴合,实践用量下函数费用通常不足 1 元。
五、演示与生产的边界要分清
演示环境为跑通链路,APIG 用无认证加调试域名,端侧跳过证书名校验;会话 token 永不过期、走 URL 查询参数、明文存在 Preferences 里。学习阶段可以接受,上生产前必须补齐三件事:token 改走 Authorization: Bearer 头并加上过期与撤销;APIG 切 APP 或 IAM 认证,AppSecret 不要放在可分发的客户端代码里;登录加上限流与审计。把“已做”和“未做”列成对照表,比假装演示代码能直接上架要负责任得多。
结语
新手建议按案例的两条路线选一条:想先跑通全链路,就拉取已验证源码部署云侧、编译安装端侧,验收标准是登录返回 code:0、8 个函数状态 ready、模拟器里注册登录、增删改、多端同步全通;想理解设计,就从一次登录的链路画一张请求流转图,再对照 base64 解码、幂等、时区这三处代码。能把这张图讲明白,端云一体的骨架就立起来了,换成签到、记账这类应用,换的只是业务字段,架构不用重画。
- 点赞
- 收藏
- 关注作者
评论(0)