ArkTS 并发选型:TaskPool 与 Worker 的那条分界线

举报
yd_299686804 发表于 2026/11/17 14:42:50 2026/11/17
【摘要】 在 ArkTS 上做耗时任务时,有两条现成的路:TaskPool 和 Worker。官方文档给了一张很长的对比表,列了十几行差异:内存模型、参数传递机制、生命周期、线程数上限、任务时长上限、优先级、取消、延时、任务依赖、串行队列、任务组、周期任务、异步队列…… 选型时最容易被带偏的,是「哪个更强」这个问题。真正决定答案的只有一条分界线:这个任务的生命周期由谁管。 我把这个结论的...
# ArkTS 并发选型:TaskPool 与 Worker 的那条分界线 ## 一、现象 在 ArkTS 上做耗时任务时,有两条现成的路:TaskPool 和 Worker。官方文档给了一张很长的对比表,列了十几行差异:内存模型、参数传递机制、生命周期、线程数上限、任务时长上限、优先级、取消、延时、任务依赖、串行队列、任务组、周期任务、异步队列…… 选型时最容易被带偏的,是「哪个更强」这个问题。真正决定答案的只有一条分界线:**这个任务的生命周期由谁管**。 我把这个结论的来源完整读了一遍,来源是 OpenHarmony 官方文档仓 `openharmony/docs`(master 分支,commit `ffd9835`)里的两篇文档:`zh-cn/application-dev/arkts-utils/taskpool-introduction.md` 和 `taskpool-vs-worker.md`,以及官方示例仓 `openharmony/applications_app_samples` 里的配套样例。 ## 二、官方给的分界线 `taskpool-vs-worker.md` 的原话是这样收尾的: > TaskPool 的工作线程会绑定系统的调度优先级,并支持负载均衡(自动扩缩容),相比之下,Worker 需要开发者自行创建和销毁,存在一定的创建和管理成本。因此,在大多数场景下,推荐优先使用 TaskPool。 > > Worker 适用于需要长时间占据线程,并由开发者主动管理线程生命周期的场景;TaskPool 适用于执行相对独立任务的场景,任务在线程中执行时无需关注线程生命周期。 把它翻译成一句可执行的判断:**任务自己会结束、你不关心它跑多久 → TaskPool;任务要一直活着、你和它之间有句柄要保持 → Worker。** 文档给的对照表里,两条差异最硬: | 维度 | TaskPool | Worker | |---|---|---| | 任务执行时长上限 | 3 分钟(不含 Promise / async-await 的 I/O 等待时长) | 无限制 | | 任务池个数上限 | 自动管理,无需配置 | 同一进程最多同时开启 64 个 Worker | | 线程复用 | 支持 | 不支持 | 「3 分钟」这个数字经常被误传成「TaskPool 不能跑长任务」。文档的 `taskpool-introduction.md` 里说得很清楚: > 任务函数的 CPU 执行时长不能超过 3 分钟(通过 Task 的 cpuDuration 属性获取)。异步 I/O 等待时间不计入此限制,可通过 ioDuration 属性获取。 也就是说,限制的是**同步 CPU 占用**,不是墙钟时间。一个跑 10 分钟网络请求的任务,只要每次 await 之间的计算都很短,就不会触发这个限制。而文档同时警告了另一个方向的风险: > 若因任务逻辑导致阻塞,使任务无法完成,将导致该线程后续无法调度其他任务。当所有线程均被超时占用时,后续提交的任务将无法正常调度执行。 这解释了 TaskPool 为什么必须「自动扩缩容」——`taskpool-introduction.md` 写明系统默认启动一个工作线程,任务多时自动扩容,工作线程数量上限由设备的物理核数决定,长时间无任务分发时会缩容。 ## 三、为什么这段约束会咬人 TaskPool 的工作线程是复用的。复用带来吞吐上的好处,也带来一个具体的故障形态:**一个卡住的任务会占住线程,而线程池的规模是按物理核数封顶的**。核数少、设备负载高的时候,几个卡住的任务就能让整个并发层瘫掉——不是那个任务失败,是后面所有任务都排不上队。 所以 TaskPool 里有几个专门用来兜底的机制,它们都是针对「任务会失控」设计的: - **取消**:支持取消已发起的任务; - **优先级**:IDLE 优先级专门标记后台耗时任务(例如数据同步、备份),它只在所有线程都空闲时才触发,且同一时间只会有一个 IDLE 任务执行; - **延时执行 / 任务依赖 / 串行队列 / 任务组 / 周期任务 / 异步队列**:这些 TaskPool 独有、Worker 全不支持的能力,本质上都是让你把「谁在什么条件下跑」这件事交给框架,而不是自己拿线程去编排。 对比之下 Worker 的能力边界正好反过来。Worker 不支持取消、不支持优先级(API version 18 之前)、不支持任务依赖、不支持串行队列、不支持任务组,也不支持线程复用——每个 Worker 创建时初始化独立的虚拟机实例(独立堆内存、解释器和模块系统),单个 Worker 的基础内存开销约为数 MB 到 20 MB。所以 Worker 的问题不是「跑不动」,而是**数量一多,内存开销成倍增加**。 ## 四、落到代码上:并发函数的四条硬约束 TaskPool 的并发函数必须用 `@Concurrent` 装饰。官方文档列了它的限制,其中最容易被忽略的是**闭包规则**: > 装饰的函数内的变量类型:允许使用局部变量、入参和通过 import 引入的变量,禁止使用闭包变量。 > > 由于 `@Concurrent` 标记的函数不能访问闭包,因此函数内部不能调用当前文件的其他函数。 官方文档给的报错示例长这样: ```ts function bar() { } @Concurrent function foo() { bar(); // 违反闭包原则,报错 } ``` 这条约束的实际影响是:**你没法把一个普通工具函数搬进 `@Concurrent` 里调用**。所有逻辑必须内联在被装饰的函数体内,或者挪到一个单独文件里用 import 引入。改造老代码时,这条比签名变化更容易被忽略——因为报错发生在装饰器校验阶段,而不是运行期。 另外三条: - **只支持在 Stage 模型的工程中使用,且仅支持在 `.ets` 文件中使用**; - **禁止标注为 generator、箭头函数、类方法**,不支持类成员函数或者匿名函数; - **从 API version 11 开始**,跨并发实例传递带方法的实例对象时,该类必须用 `@Sendable` 装饰。 还有一条和数据量直接相关:**序列化传输的数据量限制为 16MB**。以及入参类型的限制——目前不支持使用 `@State`、`@Prop`、`@Link` 等装饰器修饰的复杂类型。 ## 五、可运行的最小样例 官方示例仓 `openharmony/applications_app_samples`(master,commit `15cae41`)里的路径是: ```text code/DocsSample/ArkTS/ArkTsConcurrent/MultithreadedConcurrency/TaskPoolIntroduction/ entry/src/main/ets/managers/generaluse.ets ``` 文件内容: ```typescript import { taskpool } from '@kit.ArkTS'; @Concurrent function add(num1: number, num2: number): number { return num1 + num2; } // ... const task: taskpool.Task = new taskpool.Task(add, 1, 2); console.info(`taskpool res is: ${await taskpool.execute(task)}`); // 输出结果:taskpool res is: 3 ``` 这个样例值得注意的地方在于它的形态:一个**纯函数**,两个 number 入参,一个 number 返回值。没有类、没有成员变量、没有闭包、没有 Promise。这正是 `@Concurrent` 能通过校验的形状——不是巧合,是约束推出来的。 如果你要传可变对象过去,样例仓里另有两个配套文件演示了两种截然不同的传输语义: ```typescript // ArrayBuffer 默认转移(transfer):线程里拿到的是同一块内存的副本所有权转移 const task: taskpool.Task = new taskpool.Task(printArrayBuffer, buffer); task.setTransferList([buffer]); // 需要多次调用同一个 ArrayBuffer 时,改成拷贝传递 task.setCloneList([buffer]); ``` 文档明确说:**ArrayBuffer 参数在 TaskPool 中默认转移**。如果需要多次调用使用 ArrayBuffer 作为参数的 task,就用 `setCloneList()` 把传输行为改成拷贝,避免对原有对象产生影响。传大文件、分片处理、多次重试的时候,这条决定的是你会不会踩到「对象已被转移,第二次用就没了」的坑。 ## 六、代价与不适用场景 - **TaskPool 不是万能的**。3 分钟 CPU 上限、16MB 序列化上限、`@Concurrent` 的闭包禁令,都是硬边界。命中任何一条,就得改设计——不是加个参数能绕过去的。 - **Worker 不是「更强的 TaskPool」**。文档在内存开销那一段写得很不客气:Worker 单个基础内存开销约数 MB 到 20MB,随加载的业务模块复杂度进一步增长,多个 Worker 同时运行时内存开销成倍增加,**在内存受限的设备上尤为明显**。内存敏感场景应该优先 TaskPool。 - **本文只覆盖 TaskPool 与 Worker 的选型**,不覆盖 Worker 自己的 API 细节(`postMessage`、跨线程调用宿主线程等),那些在 `worker-introduction.md` 和 `worker-and-taskpool.md` 里。另外 API version 18 起 Worker 支持设置线程优先级了,选型时不要拿老文章的结论直接套。 - **文档和实现都可能变**。本文引用的 commit 是 `openharmony/docs` 的 `ffd9835` 和 `applications_app_samples` 的 `15cae41`,master 分支会持续更新。表里的「3 分钟」「16MB」「64 个 Worker」这些数字是**读到的当前值,不是永久保证**——真到了具体机型上,请以你自己目标版本的 API 参考文档为准。 - **示例仓的样例是教学用的最小实现**,没有覆盖错误重试、优先级、取消、任务组这些生产里真正会出问题的部分。真要上生产,请以官方 API 参考文档和 `multi-thread-concurrency-overview.md` 的并发注意事项为准。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。