鸿蒙端云一体开发实践笔记：用 ArkTS + FunctionGraph 做待办清单同步

最近在华为云鸿蒙开发实践中心过了一遍「云同步待办清单」案例，把端侧 ArkTS 与云侧 Serverless 串起来跑通，记录几个容易踩坑的点。

整体结构

端侧是 HarmonyOS ArkTS + ArkUI，云侧用 FunctionGraph 云函数 + APIG + RDS MySQL。端侧不直连数据库，所有增删改查都走 APIG 暴露的 REST 接口，云函数里做参数校验和会话校验。案例里把用户、会话、任务拆成三张表（users / sessions / tasks），这个拆分对后续加权限控制比较友好。

端侧同步策略

案例用的是 30 秒轮询同步，实现简单，但要注意两点：

1. 本地先落库再发起同步，网络失败时任务状态标为 pending，避免界面上出现「已保存但刷新后消失」。

2. 每条记录带 `updated_at` 与客户端生成的 `client_id`，服务端按 `updated_at` 做冲突判定，重复提交靠 `client_id` 幂等，防止弱网重试产生重复任务。

ArkUI 里列表用 `LazyForEach` 渲染，数据变化时只更新差异项，待办数量多时滚动明显更顺。

云函数侧的坑

• APIG 专享版要确认跨域与鉴权配置，调试阶段最容易在预检请求（OPTIONS）上卡住。

• RDS 连接放在云函数初始化阶段复用，别在每次调用里新建连接，冷启动后的首个请求延迟会明显下降。

• `deploy.sh` 一键部署之后用 `verify_api.sh` 做端到端验收，比逐个接口手测省时间。

小结

从需求到端云联调完整跑一遍约 2.5 小时，只求部署跑通约 60 分钟。对刚接触鸿蒙端云协同的开发者，这套案例的价值在于把鉴权、同步冲突、幂等这些容易后期返工的问题提前摆到了台面上，比单纯照着 UI 教程写页面收获更大。

（本文为个人在华为云开发者实践中心学习案例后的实践记录。）