Electron 调用 ArkTS:跨运行时异步回调怎样处理超时与迟到结果
一次跨语言调用,最怕的不是结果来得慢,而是结果来得太晚:JavaScript 已经收到超时,ArkTS 的业务却刚刚完成,又带着结果回来“敲门”。如果这时还接收它,可能改写已经结束的请求;如果多个请求共用状态,还可能把 A 的结果送给 B。下面以一套在鸿蒙电脑上运行的 Electron—ArkTS 桥接实现为例,看看如何让每次调用只结束一次。
一、先定义一次调用的边界
一次异步调用从 Electron 主进程发起,经过以下链路:
JavaScript Promise
↓ Node addon:参数校验,异步工作线程
↓ N-API adapter:调用 AKI,等待结果
↓ ArkTS 路由:查找处理函数,启动业务与计时器
↑ 完成回调:携带统一结果
↑ adapter:结束等待
↑ addon:在主线程完成 Promise
接口接收方法名、字符串参数和可选的 timeoutMs。同步与异步都返回 JSON 字符串,结果结构固定为 code、data、msg;异步接口的 JavaScript 返回值是 Promise<string>。参数类型错误在进入工作线程前抛出 TypeError 或 RangeError;业务失败、未知路由和等待超时则通过非零 code 返回。调用方需要分清“调用接口的参数本身无效”和“桥接已接受请求,但业务没有成功”这两类情况。
这里的超时还必须写清楚起点。当前实现的计时覆盖原生桥接执行和回调等待,但不保证覆盖工作线程排队、调用方解析结果及后续业务处理。因此 timeoutMs: 1000 不能解释成“从点击按钮开始,整个功能必在一秒内结束”。
二、两层状态机解决的是不同问题
ArkTS 层为每次请求分配独立 ID,并把完成闭包放入 pendingCallbacks。闭包内部用 settled 限制只执行一次;成功、失败、业务抛错和计时器到期都走同一个完成入口。首次完成时清除计时器、移除 Map 中的引用,再把统一结果交给原生回调。

原生层同样为每次请求创建独立的 Pending<Result>。内部用互斥锁保护 finished 和结果,用条件变量等待;无论业务回调先到,还是等待先超时,只有一方能先取得终态。Pending 由回调闭包和等待方共同持有,避免等待函数返回后,迟到回调继续访问已经释放的栈内存。
两层各自防重并非重复劳动。ArkTS 的保护阻止业务处理函数重复调用完成闭包;原生层的保护阻止超时后到达的跨语言回调改写已经结束的等待状态。两层计时器都存在时,边界时刻谁先触发可能受调度影响,所以调用方应把“超时附近得到非零结果”视为正常竞争结果,不依赖具体由哪一层先报告超时。
三、超时不是取消
假设业务发起一项需要 20 秒的系统操作,桥接等待上限是 15 秒。第 15 秒返回超时,就像排队叫号过号:等待的人离开了,窗口里的事却未必自动停下。JavaScript 调用方停止等待,并不代表系统操作被终止。业务可能在第 20 秒才回调,但这次回调应被忽略,不能让已完成的 Promise 再次改变状态。
这个区别直接影响业务设计:
- 会占用文件句柄、网络连接或系统选择器的任务,应在业务层设计取消与释放逻辑。
- 具有外部副作用的任务,即使桥接返回超时,也不能直接断言它没有执行成功。
- 重试具有副作用的请求时,需要业务层幂等键或状态查询,不能仅凭桥接超时就盲目重发。
当前桥接实现提供的是等待时限与迟到回调隔离,不提供业务取消协议。把这个边界写进接口契约,比简单承诺“超时自动终止”更重要。
四、并发时为什么不能共用一份结果
若 16 个请求同时发出,却共用一个结果变量,就像 16 个人共用一个没有姓名的收件箱:A 的回信可能被 B 拿走。当前实现让每次调用拥有自己的 Pending 对象,ArkTS 侧也为每次调用保存独立完成闭包。跨运行时函数分发入口用互斥锁保护,但锁只覆盖提交调用,不包住整个业务等待,否则所有请求会被串行化。
对于截图一类大数据请求,还需额外处理内存所有权。截图回调到达原生层时,先将二进制数据复制到由本次请求持有的容器,等待完成后再进行 Base64 编码和 JSON 包装。这样,等待方不会依赖回调参数中临时缓冲区的寿命。代价是内存拷贝与 Base64 体积增长;对大图不能宣称“零复制”。
五、用什么测试证明状态机有效
只测一次成功调用,无法发现生命周期问题。至少要覆盖以下时间顺序:正常完成;业务抛错;超时先于回调;完成后再次回调;两个并发请求采用不同超时;大数据回调;超时后再发新请求,确认旧回调没有污染新请求。
该实现的设备验证记录包含 34 项功能与超时检查,覆盖 16 路并发、约 1 MiB 数据、截图、迟到回调后的恢复等。性能对照则在同一台鸿蒙电脑、同一 HAP 内,将通用桥接与独立手写的跨运行时桥接执行相同业务:小数据同步、异步、设备信息以及 64 KiB 同步、异步五类。每类按轮交替测量,并保留逐次样本;其中一轮共有 32 万个正式计时样本,各类合并平均时延增长在该轮均低于 10%。这个结论只属于所测设备、运行库、样例和基线,不能推广成所有业务负载的性能保证。
比单个均值更有价值的是检查分轮波动和失败恢复。另一系统版本的补测中,各场景合并均值仍低于 10%,但有个别分轮超过 10%。因此性能结果应同时报告分轮、合并值、P50/P95、原始样本和对照定义;异常、超时、重复回调则要以行为断言验证,不能靠计时数字代替。
六、落地时的检查顺序
先确认 addon、adapter 与 ArkTS 包来自匹配的一组构建产物;方法绑定缺失时应返回清楚的错误。随后验证参数边界,包括空选项、非整数、无穷值及超过允许范围的超时值。最后在设备上做并发、迟到回调、进程退出和资源压力测试。当前公开验证覆盖了前述主要功能与部分性能场景;长期运行和极端退出路径仍需要独立留证。
跨语言桥接最重要的契约不是“能把函数调过去”,而是每个请求何时开始、何时结束、谁持有结果,以及超时后业务还可能发生什么。只要这四件事保持一致,Promise、原生等待与 ArkTS 回调才不会在异常路径上互相矛盾。
更多推荐



所有评论(0)