鸿蒙端云一体待办清单:从建库到端侧轮询的六个真实卡点
鸿蒙端云一体待办清单:从建库到端侧轮询的六个真实卡点
上周把「云同步待办清单」这套端云协同的最小闭环跑通了:端侧是 HarmonyOS ArkTS 应用,云侧是 8 个 FunctionGraph 函数挂在 APIG 专享版后面,数据落 RDS MySQL 的三张表(users / sessions / tasks),端侧 30 秒轮询同步。整套下来踩了六个坑,记下来给同样在鸿蒙端云之间来回的人省点时间。
一、MySQL 连接串里的时区不是小事
建库时字符集给了 utf8mb4,排序规则用默认的 utf8mb4_general_ci,连接串写成:
jdbc:mysql://<rds-ip>:3306/todo?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
第一次跑创建任务接口,前端传上来的截止日期是 `2026-11-20`,落库之后查出来变成 `2026-11-19T16:00:00.000Z`。原因是函数运行环境的时区是 UTC,MySQL 驱动按 UTC 解释不带时区的时间串。补上 `serverTimezone=Asia/Shanghai` 之后,列表接口返回的时间和端侧显示完全一致。这一步不补,后面所有的时间筛选都会差 8 小时。
二、函数侧必须复用连接池,冷启动别新建连接
FunctionGraph 的 Node.js 18.15 运行时,初始化阶段(handler 之外)创建的连接会被同一实例复用。第一版把 `mysql.createPool` 写在 handler 里面,压测时 RDS 的 `Max_used_connections` 直接冲到 300 出头,报:
Error: ER_CON_COUNT_ERROR: Too many connections
改成在模块顶层建 pool(connectionLimit 取 10,idleTimeout 60000),再把 pool 挂到全局,错误就没了。同一个实例内热请求可以拿到连接池,冷启动最多 3~5 秒,端侧加一个 8 秒超时重试足够。
三、APIG 专享版的路由和后端路径要对齐
函数的触发入口挂在 APIG 上,分组里配了 `/todo` 前缀,函数侧接收到的 `path` 却是去掉前缀之后的 `/tasks`。第一版按 `/todo/tasks` 去匹配,结果全部命中 404。要么在分组里把「路径透传」勾上,要么函数侧只认后缀,两种都行,但必须和端侧 `baseURL` 对齐。端侧 `baseURL` 用的是 APIG 的调用域名,不是函数的执行 API,这点容易搞混:
• APIG 调用域名:`https://.apig..huaweicloudapis.com`
• 函数执行 API:`https://.apigw..huaweicloudapis.com`
四、鉴权:session 放 Redis 还是放库
用户登录后下发 token,服务端校验那一层我先放在库里(sessions 表,token 做主键,附过期时间)。好处是部署简单,坏处是每个请求多一次 RDS 往返。数据量小的时候(单表万级)这个开销可以忽略,真要做秒级会话失效的话再换 Redis 更合适。
表结构长这样:
users (id, phone, nickname, created_at)
sessions(token, user_id, expires_at, created_at)
tasks (id, user_id, title, priority, due_date, done, updated_at)
`tasks` 上建了 `(user_id, updated_at)` 联合索引,列表接口按用户 + 更新时间倒序取,50 条一页,实测 3 万行下 12ms 左右。
五、端侧 30 秒轮询要处理「后台冻结」
ArkTS 侧用 `setInterval` 每 30 秒拉一次增量,带上 `updated_at > lastSync` 的参数,服务端只回变更行。真机上切到后台几分钟,定时器会被系统冻结,回来之后一次性补齐:
const delta = await fetchTasks(lastSyncTime);
delta.forEach(t => upsertLocal(t));
lastSyncTime = delta.length ? delta[delta.length - 1].updatedAt : lastSyncTime;
关键是 `lastSyncTime` 要落在本地持久化(`preferences` 里存一个字符串),否则进程一被杀就全量同步,流量和电量都不好看。
六、联调阶段的两次失败
第一次是上传函数代码包:OBS 桶的权限是私有,函数拉不到包,运行日志里只有一行 `AccessDenied`。给函数所在委托加上 `obs:object:GetObject` 之后重新发布版本才通。
第二次是验收接口:删掉一条任务后又请求了一次列表,我当时的预期是返回空数组,实际返回的是 `{"items":[],"total":0}`,判断条件写成「数组为空」就永远为真,换成判 `total == 0` 才是对的。这类问题建议在联调时把响应体完整打印出来再写判断,而不是凭印象写。
收尾
这套闭环跑通之后,端侧只需要关心三件事:token 过期重登、增量同步、本地缓存写入。云侧把连接池、路由、索引三处对齐,剩下就是扩容的事了。下一步想试试把 30 秒轮询换成 WebSocket 长连接,看看 RDS 的连接数会不会又顶到上限。
- 点赞
- 收藏
- 关注作者
评论(0)