Worker 线程通信实战：主线程与 Worker 双向消息与跨线程限制

Worker 线程通信实战主线程与 Worker 双向消息与跨线程限制前言上一篇讲了TaskPool与Concurrent见 9/6 文章它们适合“一次性计算任务”。但当你的后台逻辑是长生命周期、需要持续收发消息时——比如音视频处理、长轮询、游戏主循环——就该用Worker。本文讲清Worker的创建、双向通信以及最容易被忽略的“跨线程对象限制”。问题描述新手用Worker常踩这些坑在Worker文件里直接importUI 组件或调用promptAction.showToast直接崩溃。想传一个 class 实例给Worker结果postMessage后对方拿到的是空对象。主线程worker.postMessage后Worker收不到排查半天才发现没onmessage。Worker里报错却没有任何提示难以调试。这些都是因为Worker 运行在独立线程不共享主线程的全局对象与 UI 上下文。细节解析Worker与TaskPool的核心区别TaskPool任务式执行完即回收适合无状态纯计算。Worker常驻线程手动管理生命周期适合有状态、需持续通信的负载。通信模型主线程worker.postMessage(data)→Worker内parentPort.onmessage接收Worker内parentPort.postMessage(data)→ 主线程worker.onmessage接收。本质是结构化克隆structured clone不是共享内存。跨线程限制重点传递的是“可序列化的副本”函数、State、UI 组件、Context等都不能跨线程。大数组/大对象克隆有性能成本必要时用ArrayBuffer的transferList转移所有权零拷贝。Worker线程内没有 UI 能力不能弹 Toast、不能操作组件、不能使用window/document等。工程实践把“任务参数 回调 id”作为消息协议主线程用id匹配结果避免消息错乱。示例代码// 1) 主线程侧 Index.etsimport{worker}fromkit.ArkTSEntryComponentstruct WorkerDemo{privateworker?:worker.ThreadWorkerStateresult:string未计算aboutToAppear(){// 路径相对于当前 ets 文件所在目录的 worker 脚本this.workernewworker.ThreadWorker(entry/ets/workers/calc.worker.ts)this.worker.onmessage(e:MessageEvents){constmsge.dataif(msg.typedone){this.result结果${msg.value}}}this.worker.onerror(e){console.error(worker error:,e.message)}}aboutToDisappear(){this.worker?.terminate()}build(){Column({space:16}){Text(this.result)Button(交给 Worker 算 12...1000000).onClick((){this.worker?.postMessage({type:sum,n:1000000,id:Date.now()})})}.padding(20)}}// 2) entry/ets/workers/calc.worker.tsimport{worker}fromkit.ArkTSconstparentPortworker.workerPort parentPort.onmessage(e:MessageEvents){constmsge.dataif(msg.typesum){lettotal0for(leti1;imsg.n;i)totali// 把结果回传主线程只传可序列化数据parentPort.postMessage({type:done,id:msg.id,value:total})}}要点路径entry/ets/workers/calc.worker.ts需与build-profile.json5的buildOption.arkOptions.runtimeOnly/worker 配置匹配且 Worker 文件不能引用 UI。onmessage必须在postMessage之前注册好否则首条消息可能丢失。不再需要时务必terminate()否则常驻线程会一直占资源。总结长生命周期、需持续通信 → 用Worker一次性纯计算 → 用TaskPool/Concurrent。通信靠postMessage/onmessage走结构化克隆不共享内存。Worker内无 UI 能力不能碰组件/Context/函数。大对象用ArrayBuffertransferList零拷贝转移。注册onmessage后再发消息结束时terminate()释放线程。理解“线程隔离”这个前提Worker 的大部分异常都能提前规避。