罗罗编程学习记录
本页内容 展开查看

06.5.6.7 Channel 与协程通信

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.6 Swoole

06.5.6.7-001 Channel 是什么,解决什么问题?

一句话结论

Channel 是协程间通信与同步的队列原语:协程通过 push 写入、pop 读取,队列满/空时对应协程挂起等待,实现生产者消费者协作与结果汇总。

概念解释

协程之间不能靠共享变量安全传递消息,Channel 提供带阻塞语义的消息队列。写入方与读取方通过通道解耦:生产者只管 push,消费者只管 pop,等待时协程挂起不占 CPU。Channel 既可传消息,也可作为信号量、结果收集器使用。通道容量与阻塞语义决定并发模型。

原理流程

  1. 创建指定容量的 Channel。
  2. 生产者协程 push 数据入队。
  3. 消费者协程 pop 取数据处理。
  4. 队列满/空时对应协程挂起,待有空间/数据后唤醒。

代码或图示

use Swoole\Coroutine\Channel;

$ch = new Channel(2);
go(function () use ($ch) {
    $ch->push('job-1');
});
go(function () use ($ch) {
    echo $ch->pop();
});

常见误区

  • 把 Channel 当共享缓存:它是通信队列,取走即消费,不是长期存储。
  • 以为通道内数据进程间共享:协程 Channel 限于进程内协程,跨进程用另一类 Channel。

追问

  • Channel 与 Table 分工?答:Table 存跨进程共享状态,Channel 做协程间消息传递与同步;场景不同。
  • 通道里能传什么?答:标量与数组/对象引用均可入队;对象跨协程共享引用需注意可变状态。

06.5.6.7-002 无缓冲与有缓冲 Channel 的容量语义是什么?

一句话结论

容量为 0 是无缓冲通道:push 与 pop 必须配对相遇才交换数据;容量大于 0 是有缓冲通道,数据先入队,消费者按序取出,队列未满可继续 push。

概念解释

无缓冲(容量 0)下,push 会挂起直到有消费者 pop,数据不经过队列暂存;有缓冲下,生产者可先写入到容量上限,消费者空闲时再取。容量决定解耦程度:容量越大生产者与消费者节奏越能错开,但积压数据也越多。容量创建后不可调整,具体语义细节以官方文档为准。

原理流程

  1. 构造 Channel 时传入容量。
  2. 容量 0:push 等待 pop 配对,直接交接。
  3. 容量 N:数据入环形/队列缓冲,未满 push 不挂起。
  4. 队列满后 push 挂起,直到消费者取出腾出空间。

代码或图示

use Swoole\Coroutine\Channel;

$unbuffered = new Channel(0);   // 无缓冲:收发配对
$buffered = new Channel(16);    // 有缓冲:可暂存 16 条

常见误区

  • 以为容量 0 表示“不能存数据”:无缓冲仍可交接,只是不暂存。
  • 缓冲容量设过大:积压消息延迟升高,背压失效。

追问

  • 容量怎么定?答:按生产消费速率差与可接受积压量设定;压测观察队列长度与等待时长。
  • 无缓冲适合什么场景?答:需要严格同步交接、控制并发节奏的场景;一般异步解耦用有缓冲。

06.5.6.7-003 push 的阻塞语义是怎样的?

一句话结论

队列未满时 push 直接入队返回;队列满时当前协程挂起等待,直到有消费者取出数据或超时;超时与关闭后的返回约定以版本为准。

概念解释

push 是背压的关键:生产者不能无限往通道塞数据。满队挂起让生产者降速,与消费者速率匹配。push 可带超时参数,超时未入队按返回值判断失败;通道被关闭后继续 push 的行为需核对文档。返回值类型与错误码标注待确认。

原理流程

  1. 生产者调用 push 写入数据。
  2. 队列有空位:数据入队,唤醒等待的消费者,返回成功。
  3. 队列已满:协程挂起,等待消费腾出空间。
  4. 被唤醒后重试入队;超时或关闭则按约定返回失败。

代码或图示

use Swoole\Coroutine\Channel;

$ch = new Channel(1);
go(function () use ($ch) {
    $ok = $ch->push('item', 1.0); // 超时参数单位与返回值以文档为准
    var_dump($ok);
});

常见误区

  • 不检查 push 返回值:超时/关闭时数据未入队,业务需感知失败。
  • 把满队挂起当成报错:挂起是正常背压行为,不是异常。

追问

  • push 挂起时占用什么?答:占用协程栈与通道等待项,不占执行权;有空间后唤醒。
  • 超时单位是什么?答:参数单位(秒/毫秒)以官方文档为准,待确认。

06.5.6.7-004 pop 的阻塞语义是怎样的?

一句话结论

队列非空时 pop 取出队首数据;队列为空时协程挂起等待,直到有生产者写入、超时或通道关闭;返回值需区分数据、超时与关闭状态。

概念解释

消费者在空通道上挂起,新数据入队后被唤醒取走。pop 可带超时参数,避免无限等待。通道关闭后 pop 的行为(返回剩余数据还是特定标识)以版本约定为准,业务需判断返回状态而不是只取数据。多消费者等待同一通道时,一条数据只唤醒一个消费者。

原理流程

  1. 消费者调用 pop。
  2. 队列有数据:取出队首,唤醒等待的生产者,返回数据。
  3. 队列空:协程挂起等待写入。
  4. 数据到达/超时/关闭后恢复,按约定返回结果。

代码或图示

use Swoole\Coroutine\Channel;

$ch = new Channel(1);
go(function () use ($ch) {
    $data = $ch->pop(1.0); // 超时与关闭返回约定以文档为准
    var_dump($data);
});

常见误区

  • 把 pop 返回的 false 一律当数据:需结合错误码/状态区分“假数据”与超时关闭。
  • 多消费者重复消费同一条:通道消息取走即移除,一条数据只被一个消费者拿到。

追问

  • 通道关闭后 pop 还能取剩余数据吗?答:行为以官方文档为准,待确认;设计消费循环时按关闭状态退出。
  • pop 超时返回什么?答:返回值与错误标识按版本核对,业务分支需覆盖超时场景。

06.5.6.7-005 生产者消费者模型如何用 Channel 实现?

一句话结论

一个通道连接多个生产者与多个消费者:生产者并发 push 任务,消费者并发 pop 处理,通道缓冲削峰,挂起/唤醒自动平衡两侧速率。

概念解释

多生产者多消费者下,通道承担任务队列与并发协调:生产者数量与消费者数量可独立配置,消费者从同一通道取任务。缓冲容量平滑短时速率差;满队背压生产者,空队挂起消费者。任务结果可通过另一组结果通道回传。模型需处理任务失败、超时与通道关闭。

原理流程

  1. 创建任务通道与结果通道。
  2. 启动若干消费者协程循环 pop 任务。
  3. 生产者协程把任务 push 进通道。
  4. 消费者处理后经结果通道回传,主协程汇总。

代码或图示

use Swoole\Coroutine\Channel;

$tasks = new Channel(8);
$results = new Channel(8);

for ($i = 0; $i < 3; $i++) {
    go(function () use ($tasks, $results) {
        while ($task = $tasks->pop()) {
            $results->push(strlen((string)$task));
        }
    });
}

go(function () use ($tasks) {
    foreach (['a', 'bb', 'ccc'] as $item) {
        $tasks->push($item);
    }
});

常见误区

  • 消费者循环不退出:通道关闭后循环条件需正确终止,避免空转挂起。
  • 结果通道无人消费:结果积压会反压生产者,需配套汇总协程。

追问

  • 消费者数怎么定?答:按任务耗时与下游承载力调整;消费者过多会压垮下游。
  • 任务失败怎么传递?答:结果通道携带状态标识(成功/失败/错误),消费方分支处理。

06.5.6.7-006 多生产者多消费者如何分配消息?

一句话结论

通道内每条消息只被一个消费者取走,消费者竞争同一队列;负载均衡由通道等待队列决定,先等待的消费者优先拿到新数据。

概念解释

多个消费者挂在同一空通道上,一条新消息唤醒其中一个等待者,不会广播给全部消费者。生产者无需关心任务分给谁。消息顺序按入队顺序取出;消费者处理速度不同会自然形成排队。需要广播给所有消费者时,不能用单通道,需为每个消费者独立通道或遍历推送。

原理流程

  1. 多个消费者在空通道上挂起等待。
  2. 生产者写入一条消息。
  3. 通道唤醒一个等待消费者,消息出队。
  4. 其余消费者继续等待下一条消息。

代码或图示

use Swoole\Coroutine\Channel;

$ch = new Channel(4);

for ($i = 0; $i < 3; $i++) {
    go(function () use ($ch, $i) {
        while ($job = $ch->pop()) {
            echo "consumer {$i} got {$job}\n";
        }
    });
}

常见误区

  • 以为一条消息推送给所有消费者:单通道是竞争消费,不是广播。
  • 要求消息定向到指定消费者:需按目标分通道或使用定向发送机制。

追问

  • 消费顺序能保证吗?答:单通道 FIFO 出队;各消费者处理完成顺序不保证。
  • 某个消费者卡住影响其他人吗?答:卡住只影响自身领取速度,其他消费者继续取任务;堆积在通道与生产侧体现。

06.5.6.7-007 跨进程 Channel 与协程 Channel 有什么区别?

一句话结论

协程 Channel(Coroutine\Channel)用于同进程内协程间通信;跨进程 Channel(Swoole\Channel)基于共享内存,用于进程间传递数据,两者用途、容量语义与 API 不同。

概念解释

协程 Channel 挂起/恢复协程,队列在进程内存中;跨进程 Channel 映射共享内存,在进程间传递消息,阻塞行为面向进程/线程而非协程。不要把两类通道混用:进程间协程队列无法直接通信,同进程协程也不必用共享内存通道。具体 API 与容量限制以官方文档为准。

原理流程

  1. 同进程协程协作:创建 Coroutine\Channel。
  2. 跨进程消息传递:创建共享内存 Swoole\Channel。
  3. 两类通道分别按各自语义 push/pop。
  4. 选型先确认通信双方是否在同一进程。

代码或图示

use Swoole\Coroutine\Channel;
use Swoole\Channel as IpcChannel;

$coCh = new Channel(4);        // 进程内协程通信
$ipcCh = new IpcChannel(1024 * 64); // 跨进程共享内存,容量单位以文档为准

常见误区

  • 用协程 Channel 在 Worker 间传消息:Worker 进程间不可见。
  • 混淆两类通道的返回值与超时语义:API 行为不同,需分别核对。

追问

  • 跨进程通道容量怎么算?答:共享内存段大小,按消息大小与积压量估算;具体接口以文档为准。
  • 跨进程通信还有哪些方式?答:Table/Atomic 共享状态、任务队列、网络协议;按消息类型与场景选择。

06.5.6.7-008 通道关闭(close)后行为是怎样的?

一句话结论

close 标记通道关闭,阻止继续写入;已入队数据能否继续 pop、关闭后 push/pop 的返回行为以版本约定为准,消费循环需识别关闭状态并退出。

概念解释

关闭通道用于通知消费者“不再有新消息”。关闭时机要在所有生产者写完之后;提前关闭会导致后续 push 失败。关闭后残留数据的处理、pop 返回标识、重复关闭行为都需核对文档。业务应把“通道关闭”作为正常终止信号,而不是异常错误。

原理流程

  1. 生产者全部写完,调用 close。
  2. 通道标记关闭,禁止新的 push。
  3. 消费者按约定取完残留数据或识别关闭标识。
  4. 消费循环退出,协程收尾。

代码或图示

use Swoole\Coroutine\Channel;

$ch = new Channel(2);
go(function () use ($ch) {
    $ch->push('a');
    $ch->close(); // 写完后关闭;关闭后行为以文档为准
});

常见误区

  • 生产者还在写就 close:后续 push 失败,消息丢失。
  • 消费循环不判断关闭:空通道上无限挂起或重复错误返回。

追问

  • 关闭后再 push 会怎样?答:返回失败或抛异常,具体行为以版本为准,待确认。
  • 如何优雅通知所有消费者退出?答:关闭通道作为终止信号,消费者 pop 到关闭标识后退出循环。

06.5.6.7-009 Channel 异常与协程唤醒有哪些需要注意?

一句话结论

超时、通道关闭、协程被终止都会导致等待中的协程被唤醒;唤醒后必须检查返回状态,区分正常取到数据与异常/超时退出,避免把失败当成功数据处理。

概念解释

挂起在 Channel 上的协程可能因多种原因恢复:有数据、超时、通道关闭、协程退出。唤醒后返回值/错误码标明原因。若不做分支判断,可能把超时标识当成业务数据,或在通道关闭后继续消费。异常任务应在生产者/消费者内部捕获,避免协程静默退出导致通道无人生产或消费。

原理流程

  1. 协程在 push/pop 上挂起等待。
  2. 事件就绪、超时、关闭或终止触发唤醒。
  3. 检查返回值与错误标识确定原因。
  4. 正常分支处理数据,异常分支记录并收尾。

代码或图示

go(function () use ($ch) {
    $data = $ch->pop(1.0);
    if ($data === false) {
        echo "pop timeout or closed\n"; // 具体错误标识按版本核对
        return;
    }
    echo "got " . $data . "\n";
});

常见误区

  • 唤醒后直接使用返回值:未区分超时/关闭与正常数据。
  • 消费者协程抛异常退出:通道仍在但无人消费,生产者最终满队挂起。

追问

  • 如何获取失败原因?答:通道错误码相关接口以官方文档为准;业务记录 CID 与操作类型便于排查。
  • 协程终止后通道残留怎么办?答:残留消息随通道释放;长期挂起通道需排查是否生产者/消费者缺失。

06.5.6.7-010 Swoole Channel 与 Go channel 有哪些主要差异?

一句话结论

两者都是带阻塞语义的通道原语,但 Go 语言内建 select、方向类型与关闭语义更完整;Swoole 协程 Channel 是扩展组件,API 与并发模型围绕 PHP 协程运行时,对照理解即可,不逐一照搬 Go 用法。

概念解释

Go channel 支持 select 多通道监听、发送/接收方向声明、关闭后接收零值等语言级语义。Swoole Channel 提供 push/pop/close 与容量语义,多通道等待、方向约束等能力以扩展实际接口为准。面试对照时先确认本机版本支持的方法,不把 Go 语法特性直接套到 PHP 运行时。

原理流程

  1. 对照容量语义:无缓冲/有缓冲。
  2. 对照阻塞唤醒:满 push、空 pop 挂起。
  3. 核对各自关闭与错误约定。
  4. 多通道并发等待按 Swoole 实际支持的方式实现。

代码或图示

use Swoole\Coroutine\Channel;

$ch1 = new Channel(1);
$ch2 = new Channel(1);
// 多通道等待方式以扩展接口为准;Go select 式语法在 PHP 中不直接存在

常见误区

  • 照搬 Go select 写法:PHP 侧没有语言级 select 语法,需用接口或并发编排实现。
  • 假设关闭语义完全一致:零值返回、重复关闭等行为需按各自文档核对。

追问

  • Swoole 有没有 WaitGroup 类工具?答:扩展/框架可能提供并发编排组件;本章节只引用,具体组件见后续专题。
  • 通道方向能声明吗?答:Swoole Channel 不做发送/接收方向类型约束;接口使用上自行约定。

06.5.6.7-011 什么是 Channel 死锁,典型场景有哪些?

一句话结论

死锁指协程在通道上永久挂起且无人唤醒:单协程自 push 自 pop 顺序错误、消费者缺失、生产者缺失或通道等待形成循环,都可能导致协程卡住无法继续。

概念解释

Channel 挂起必须有对应方唤醒:push 满队需要消费者 pop,pop 空队需要生产者 push。典型死锁:同一协程先 push 满容量通道再 pop(无缓冲下自交接也需调度配合);只启动生产者没有消费者;只等结果没人生产。死锁协程长期占用栈与等待项,表现为任务不返回、协程堆积。

原理流程

  1. 协程在空通道上 pop,无生产者写入。
  2. 或通道满后 push,无消费者取出。
  3. 等待方挂起后无人唤醒。
  4. 协程永久停在通道等待点,任务超时也不返回。

代码或图示

use Swoole\Coroutine\Channel;

$ch = new Channel(0);
go(function () use ($ch) {
    $ch->push('x'); // 无缓冲:需有消费者配对,否则挂起
    $ch->pop();
});

常见误区

  • 以为单协程内 push 再 pop 一定能自行解开:无缓冲通道需要调度到配对方,顺序错误即死锁。
  • 忽略消费者协程启动失败:生产者满队后全部挂起。

追问

  • 死锁与阻塞调用如何区分?答:阻塞调用有返回时机,死锁是永久等待;结合等待时长与通道两端是否存在判断。
  • 如何避免?答:push/pop 配对称启动,通道操作加超时,编排时先确认生产消费双方就绪。

06.5.6.7-012 如何排查 Channel 相关死锁与挂起?

一句话结论

排查按“等待点 → 通道容量 → 生产者/消费者是否存在 → 是否超时 → 协程退出原因”定位;用超时兜底、协程清单与通道状态接口逐步缩小范围。

概念解释

挂起排查先确认卡在 push 还是 pop:满队阻塞说明消费不足,空队阻塞说明生产不足。检查对应协程是否启动、是否异常退出、通道是否被关闭。所有通道等待都应设超时兜底,避免永久挂起。扩展提供的通道统计与协程状态接口名以版本为准,缺失时业务侧记录等待点日志。

原理流程

  1. 定位挂起协程的操作:push 满队还是 pop 空队。
  2. 检查生产者/消费者协程是否存活、是否报错退出。
  3. 核对通道容量与积压数量。
  4. 检查超时设置与关闭时序,修复配对或补超时。

代码或图示

go(function () use ($ch) {
    $data = $ch->pop(2.0); // 超时兜底,避免永久挂起
    if ($data === false) {
        echo "channel wait timeout\n";
    }
});

常见误区

  • 等待不设超时:死锁无法被超时机制发现,只能靠人工排查。
  • 只看通道不看协程退出:消费者异常退出后通道长期无人消费。

追问

  • 如何列出挂起协程?答:扩展协程统计接口与业务埋点结合;接口名以版本文档为准,待确认。
  • 线上如何快速止血?答:超时兜底返回降级结果,先恢复可用,再排查生产消费配对。

06.5.6.7-013 Channel 与 Table 通信场景如何取舍?

一句话结论

需要传递消息、同步等待与交接数据用 Channel;需要多方读取的共享状态、计数与元数据用 Table。Channel 消息取走即消失,Table 按键长期保留。

概念解释

Channel 是流式队列:数据被消费者取走后不在通道留存,适合任务传递、结果回传、信号通知。Table 是共享键值表:数据按键存在,多个进程可反复读取,适合在线状态、配置镜像。混用场景:Channel 传递任务,任务处理结果需要全局可见时再写入 Table。两者跨进程能力也不同。

原理流程

  1. 判断需求:一次性消息交接还是长期共享状态。
  2. 消息流、任务、结果回传选 Channel。
  3. 全局状态、计数、连接元数据选 Table。
  4. 复合场景通道传消息,Table 落共享状态。

代码或图示

use Swoole\Coroutine\Channel;
use Swoole\Table;

$ch = new Channel(8);              // 任务传递
$table = new Table(1024);          // 共享状态
$table->column('online', Table::TYPE_INT, 4);
$table->create();

常见误区

  • 用 Channel 存需要反复读取的状态:消息消费后不可回溯。
  • 用 Table 做任务队列:缺少等待唤醒语义,消费者需轮询,效率低。

追问

  • 通知事件用哪个?答:轻量信号可用 Channel 交接;需要多方读取的状态变更记录用 Table 或外部队列。
  • 跨进程消息走哪个?答:协程 Channel 不跨进程;跨进程用 Ipc Channel、任务队列或网络通道。

06.5.6.7-014 Channel 容量规划与背压如何设计?

一句话结论

容量按生产消费速率差与可接受积压设定,配合 push 超时与消费者并发控制形成背压;容量过大积压延迟高,过小生产者频繁挂起。

概念解释

缓冲容量是削峰垫:短时生产快于消费时吸收积压。规划依据是任务大小、消费耗时与可接受排队延迟。满队挂起本身就是背压:生产者降速与消费侧匹配。需要防止通道无限积压,配合超时、拒绝策略与消费者扩容。积压指标(通道长度、等待协程数)应纳入监控。

原理流程

  1. 估算生产速率、消费速率与单条任务大小。
  2. 按可接受积压量设定通道容量。
  3. push 设超时,超限按拒绝/降级策略处理。
  4. 监控队列长度与等待时长,回调容量与消费者数。

代码或图示

use Swoole\Coroutine\Channel;

$jobs = new Channel(32); // 容量按速率差与积压预算设定
$ok = $jobs->push($task, 1.0);
if ($ok === false) {
    // 队列满超时:降级或拒绝,策略按业务设计
}

常见误区

  • 容量设成无限大:背压失效,内存被积压任务占满。
  • 只设容量不设超时:满队生产者永久挂起。

追问

  • 如何观测积压?答:通道长度与等待协程数统计接口以版本为准;业务可在入队/出队埋点计数。
  • 消费跟不上怎么扩容?答:增加消费者协程数,前提是下游承载力允许;否则优先限流生产者。

06.5.6.7-015 如何用 Channel 汇总并发结果?

一句话结论

主协程为每个子任务分配结果通道或共用结果通道,子协程处理完 push 结果,主协程按任务数 pop 汇总;配合任务计数保证收齐所有结果。

概念解释

并发派发多个子协程后,主流程需要等待全部完成并收集结果。常见模式:共用结果通道,主协程循环 pop 到任务总数为止;或每任务一个通道。任务异常也要回传结果标识,避免主协程少收一条永久挂起。超时与部分失败策略按业务设计。

原理流程

  1. 发起 N 个并发子协程。
  2. 每个子协程完成后把结果 push 进结果通道。
  3. 主协程循环 pop N 次收集结果。
  4. 超时或部分失败按策略处理,汇总返回。

代码或图示

use Swoole\Coroutine\Channel;

$results = new Channel(3);
$urls = ['a', 'b', 'c'];

foreach ($urls as $url) {
    go(function () use ($results, $url) {
        $results->push($url . ':done');
    });
}

$collected = [];
for ($i = 0; $i < count($urls); $i++) {
    $collected[] = $results->pop(2.0);
}

常见误区

  • 不按任务数收齐就返回:部分结果丢失;或少收导致主协程永久挂起。
  • 子协程异常不回传:主协程等待缺失结果,超时才发现。

追问

  • 有没有 WaitGroup 工具?答:扩展/框架可能提供并发同步组件;按项目可用组件选择,本页只描述 Channel 思路。
  • 部分失败如何处理?答:结果携带成功/失败标识,主协程汇总后决定重试或降级。

06.5.6.7-016 通道关闭后再 push、重复 close 等行为如何核对?

一句话结论

关闭后写入、重复关闭、空通道 pop 等边界行为的返回值与异常形式随版本不同,不能凭印象编码;应在目标版本实测并对照官方文档,不确定处标注待确认。

概念解释

边界语义包括:close 后 push 返回失败还是抛异常、能否再次 close、close 后 pop 是否返回残留数据、未 push 过的通道状态。这些细节在不同版本可能调整。编写健壮代码时,先在测试环境用最小脚本验证边界行为,再写分支判断;接口常量与错误码以官方文档为准。

原理流程

  1. 列出需要覆盖的边界操作。
  2. 目标版本最小脚本逐项验证返回值与异常。
  3. 记录行为约定与版本号。
  4. 业务代码按实测结果写分支,不确定项标注待确认。

代码或图示

php --ri swoole
use Swoole\Coroutine\Channel;

$ch = new Channel(1);
$ch->close();
// 以下行为在目标版本实测核对:返回 false 还是抛出异常
// $ch->push('x');

常见误区

  • 凭其他语言/旧版本经验判断边界:行为约定可能不同。
  • 边界分支缺失:线上遇到关闭时序问题时报错或悬挂。

追问

  • 验证脚本怎么写?答:分别构造关闭后 push、重复 close、空队 pop 场景,打印返回值与异常类型。
  • 文档未覆盖怎么办?答:标注待确认,记录版本与实测结果,升级版本后回归。

06.5.6.7-017 协程退出后 Channel 残留会导致什么问题?

一句话结论

协程异常退出后,它持有的通道等待项与未消费消息可能残留,导致对端协程永久挂起或内存缓慢累积;需要超时兜底与退出时清理通道引用。

概念解释

生产者协程崩溃,消费者在空通道永久等待;消费者崩溃,生产者满队永久挂起。通道对象若被长生命周期结构持有,未消费消息也不释放。排查时区分“正常待消费积压”与“对端已退出的残留”。协程退出原因(异常、超时、被终止)需记录日志。

原理流程

  1. 某一侧协程异常退出,未完成通道交接。
  2. 对端在 push/pop 上挂起,等待已不存在的配对方。
  3. 通道与消息随引用持有而残留。
  4. 超时兜底触发降级,清理引用避免累积。

代码或图示

go(function () use ($ch) {
    try {
        // 任务处理
    } catch (Throwable $e) {
        $ch->push(['ok' => false, 'error' => $e->getMessage()]); // 异常也回传结果
    }
});

常见误区

  • 协程内异常不回传结果:对端等待缺失消息挂起。
  • 通道被全局长生命周期数组持有:残留消息无法随协程回收。

追问

  • 如何发现对端已退出?答:结合协程状态监控与超时;通道接口是否提供等待者数量以版本为准。
  • 残留消息如何释放?答:通道引用被移除后随回收;长生命周期持有的通道需在结束时显式清理。

06.5.6.7-018 Channel 提供哪些状态查询方法?

一句话结论

通道可查询当前长度、是否为空/已满等状态(方法名以版本为准),用于监控积压与背压判断;统计类方法不要在高频路径频繁调用。

概念解释

状态查询帮助判断积压程度:当前消息数、空/满标识、等待者数量等。具体方法名与返回字段随版本不同,需对照文档。监控场景周期性采样即可;在请求回调里反复查询通道状态会增加开销。通道容量与长度是两个概念:容量是创建时设定的上限,长度是当前积压条数。

原理流程

  1. 业务需要判断积压时调用状态查询接口。
  2. 读取当前长度与空/满状态。
  3. 结合消费者负载判断是否需要扩容或限流。
  4. 监控任务周期性采样,避免高频查询。

代码或图示

use Swoole\Coroutine\Channel;

$ch = new Channel(8);
$ch->push('x');
var_dump($ch->length()); // 方法名与返回值以官方文档为准
var_dump($ch->isEmpty());

常见误区

  • 混淆容量与长度:容量固定,长度随积压变化。
  • 高频调用统计方法:本身成为开销,采样采集即可。

追问

  • 等待者数量能查吗?答:是否提供等待协程数接口以版本为准,待确认。
  • 状态查询有锁开销吗?答:查询与读写共享通道状态,具体锁粒度以实现为准。

06.5.6.7-019 协程上下文与 Channel 如何配合使用?

一句话结论

Channel 负责跨协程交接消息与同步,协程上下文负责保存当前协程私有请求态;两者不互相替代,跨协程传递的数据经 Channel 显式交接,请求态留在各自上下文。

概念解释

请求态(用户、链路 ID)属于当前协程私有,不放进 Channel 广播;需要跨协程传递的数据(任务、结果、信号)经 Channel 交接。子协程上下文是否继承取决于运行时实现,不能依赖上下文自动跨协程;需要共享的标识作为消息字段显式带入通道。

原理流程

  1. 主协程保存请求态到私有上下文。
  2. 派发子协程时,所需数据作为消息字段 push 进通道。
  3. 子协程从通道取消息,在自己的上下文中处理。
  4. 结果经结果通道回传,上下文不跨协程迁移。

代码或图示

use Swoole\Coroutine\Channel;

$ch = new Channel(2);
go(function () use ($ch) {
    $message = $ch->pop();
    // $message 中显式携带 trace_id 等需要传递的字段
    echo $message['trace_id'] . "\n";
});

常见误区

  • 把上下文对象塞进通道期望自动传播:上下文私有,通道只传消息数据。
  • 消息里携带可变请求对象引用:多协程共享可变对象需评估竞争。

追问

  • 链路 ID 如何贯穿并发子协程?答:作为消息字段显式传入;框架上下文传播机制见框架层专题。
  • 通道消息能存资源句柄吗?答:连接等资源不宜跨协程随意交接,需走连接池借还规则。

06.5.6.7-020 Channel 使用中有哪些常见误用?

一句话结论

常见误用包括:无超时永久等待、生产者消费者未配对、通道当长期缓存、跨进程误用协程通道、异常不回传导致对端挂起、容量与背压失控;编码时逐项核对即可规避。

概念解释

误用大多源于把 Channel 当成普通数组或消息队列而忽略阻塞语义。审查 Channel 代码时检查:两端协程是否都启动、push/pop 是否配对、是否有超时、关闭时序是否正确、通道用途是否匹配(消息 vs 状态、进程内 vs 跨进程)。线上问题多表现为协程挂起、积压上涨与结果收集不全。

原理流程

  1. 审查通道创建:容量、用途与通信双方进程范围。
  2. 核对生产消费配对与启动顺序。
  3. 检查每个 push/pop 的超时与返回值分支。
  4. 确认关闭时序与异常回传,纳入监控指标。

代码或图示

use Swoole\Coroutine\Channel;

$ch = new Channel(4);

go(function () use ($ch) {
    $item = $ch->pop(2.0);
    if ($item === false) {
        return; // 超时/关闭分支
    }
    // 处理 $item
});

常见误区

  • 复制示例代码不补超时与失败分支:示例只演示主路径。
  • 通道数量随业务无限创建:未关闭的通道持有协程引用,造成泄漏。

追问

  • Code Review 检查清单有哪些?答:配对、超时、关闭时序、跨进程范围、异常回传、容量背压。
  • 哪些行为必须实测核对?答:关闭后操作返回值、超时单位、状态查询方法名;附版本号与验证命令。