Swoole中onTask与onFinish数据传递的区别

先明确一个核心前提：Swoole 的 task() 和 onFinish 回调之间，数据传递的规则并不复杂，但很多人栽在“以为它会自动处理序列化、以为两个进程能共享变量”这些默认假设上。下面把这几个关键点拆开说清楚。

onTask 接收的参数是原始投递数据，不自动反序列化

你在 task() 里扔进去什么，onTask 回调拿到的就是什么——数组、字符串、对象（已序列化）、null 都有可能。Swoole 底层只负责搬运字节流，不会帮你调用 unserialize() 或 json_decode()。

最常见的翻车场景：有人在 onTask 里直接修改对象的属性，以为这样能改回 Worker 进程里的原对象；或者传了个 JSON 字符串，没手动 json_decode 就直接当数组用，结果报错。

• 如果传的是对象，它只是序列化后的副本，onTask 中拿到的是反序列化后的独立副本，改了也不会影响 Worker 里的原对象
• 数据超过 8KB 时，Swoole 会自动写入临时文件，onTask 内部读取文件内容并返回，你感觉不到文件操作，但得确保临时目录可写、磁盘空间够用
• 数据库连接、CURL 句柄这类资源型对象不能传，一传就是 PHP 致命错误，连警告都不会给

onFinish 的 $data 是 onTask 返回值，类型由 onTask 决定

onFinish 的第三个参数 $data 不是原始投递数据，而是 onTask 里 return 的值，或者 $server->finish($data) 的参数。它同样经过 Swoole 的序列化/反序列化流程，最终类型完全取决于 onTask 怎么返回。

典型的用法：你在 onTask 里处理完逻辑，然后 return 'ok' 或者 return ['status' => 'success']，这些值就会原样出现在 onFinish 的 $data 中。

• onTask 既没 return 也没调用 $server->finish() → onFinish 根本不会触发
• 如果 onTask 返回 null，那 onFinish 的 $data 就是 null，不是空字符串也不是空数组
• 若返回一个大对象，同样受 8KB 限制影响：超限走临时文件，但反序列化后依然是完整对象，开发者感知不到差异

数据大小影响传输路径，但不改变语义

Swoole 对 8KB 以内和以上的数据采用不同传输机制，但这对开发者是透明的——你不需要判断大小再写两套逻辑。不过了解底层细节很有必要，否则遇到性能抖动或临时文件报错会一头雾水。

注意两者在参数上的根本区别：onTask 的 $data 是“输入”，onFinish 的 $data 是“输出”，它们之间没有自动映射关系，一切全靠你显式传递。

• 小于 8KB：走 Unix socket 管道，速度快，没有磁盘 I/O
• 大于 8KB：写入系统临时目录（比如 /tmp），onTask 启动时读取文件，onFinish 不涉及这个过程
• 临时目录不可写会导致任务静默失败，错误日志里通常只显示 “failed to write task file”，不会直接提权限问题

onTask 和 onFinish 不在同一个进程，无法共享内存

onTask 在 TaskWorker 进程执行，onFinish 在投递任务的那个 Worker 进程执行。两个独立进程，各有各的 PHP 运行环境、全局变量、静态属性、数据库连接。

最容易踩的坑：有人在 onTask 里改了某个 static::$cache，指望 onFinish 能读到；或者在 onTask 里打开了文件句柄，想在 onFinish 关闭它——都不行，进程隔离是硬边界。

• 所有跨进程通信必须通过 task() → onTask → finish() → onFinish 这条链路显式传递
• 不能依赖 global、static、$_SESSION 等做状态同步
• 如果真需要共享状态，得借助 Redis、APCu（仅限单机）或 SwooleTable

说白了，真正麻烦的从来不是怎么传数据，而是传完之后误以为两边还能互相影响。进程边界比代码缩进还难跨越，早想清楚早省心。