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

06.5.7.4 Channel 协程通信

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

06.5.7.4-001 Channel 在 Swow 协程模型中的定位是什么?

一句话结论

Swow\Channel 是协程间传递数据的首选通信设施,按 CSP 模型在生产者与消费者协程之间做排队、阻塞唤醒与背压控制;协程间共享状态应优先通过 Channel 传值,而不是直接读写共享变量。

概念解释

Channel 内部维护一个元素队列与等待中的读写协程。写入方在队列满时挂起,读出方在队列空时挂起;条件满足后调度器唤醒对应协程。相比裸 yield/resume,Channel 覆盖多生产者多消费者场景,调度性能与边界处理更完善。同步等待(只等完成不传数据)由 Sync 设施承担,数据传递走 Channel。

原理流程

  1. 创建 Channel 并确定容量策略。
  2. 生产者协程 push() 写入数据,满则挂起等待空位。
  3. 消费者协程 pop() 读取数据,空则挂起等待数据。
  4. 生产/消费结束后 close() 通知等待者,存量数据取完。

代码或图示

<?php
// 文档示例(未实测):Channel 基本骨架
use Swow\Channel;
use Swow\Coroutine;

$channel = new Channel(4);
Coroutine::run(static function () use ($channel): void {
    $channel->push("task-1");
});
$item = $channel->pop(1000);

常见误区

  • 把 Channel 当普通数组用:Channel 的价值在阻塞唤醒与协程安全,无并发场景用数组即可。
  • 用全局变量在协程间传值:可变共享状态需要额外同步,Channel 把排队与唤醒封装好。

追问

  • Channel 与 WaitGroup 分工?答:Channel 传数据,WaitGroup 只计数等待完成;两者可组合使用。
  • 数据在 Channel 中是拷贝还是引用?答:PHP 变量按引用计数规则传递,对象传递引用;具体语义以实现为准(待确认)。

06.5.7.4-002 构造容量 0、正数、-1 分别是什么语义?

一句话结论

new Channel(int $capacity):0 为无缓冲通道(会合式,收发需同时就位);正整数为有界缓冲队列;-1 为无上限通道;其他负数抛 ValueError。

概念解释

容量决定积压能力:无缓冲通道每次 push 都要等到有消费者正在 pop 才完成;有界通道允许最多积压 capacity 个元素,超出后生产者挂起;无上限通道不限制队列长度,风险是内存随生产速度膨胀。容量选择要结合下游处理能力与背压需求。

原理流程

  1. 无缓冲(0):push 与 pop 配对唤醒,不暂存元素。
  2. 有界(N>0):队列长度达到 N 后生产者阻塞,消费者取走空位后唤醒。
  3. 无上限(-1):push 不因队列长度阻塞,只受超时与内存约束。
  4. 非法负数:构造阶段抛 ValueError。

代码或图示

<?php
// 文档示例:三种容量构造形态
use Swow\Channel;

$rendezvous = new Channel(0);   // 无缓冲
$bounded    = new Channel(16);  // 有界缓冲
$unlimited  = new Channel(-1);  // 无上限

常见误区

  • 以为容量 0 不能传值:0 是会合语义,双方就位时直接交接。
  • 默认选 -1 图省事:下游变慢时内存无界增长,必须评估积压上限。

追问

  • 容量上限能动态调整吗?答:构造后容量由 getCapacity() 读取;是否支持动态修改待确认,以 API 文档为准。
  • 队列长度如何查看?答:getLength() 返回当前排队元素数。

06.5.7.4-003 push() 的阻塞语义与超时参数是什么?

一句话结论

push(T $data, int $timeout) 把数据写入通道;队列满时当前协程挂起等待空位,$timeout 为毫秒超时;超时或通道关闭抛 ChannelException,成功返回通道对象自身。

概念解释

push 在队列未满时直接入队并返回;满队时发生上下文切换,等待消费者取走元素。超时参数控制最长等待时间,超时抛异常(错误码 -110,以文档为准);通道被关闭后 push 抛关闭异常(错误码 -9758,以文档为准)。即使队列非空,文档也标注切换可能发生,不能假设 push 永不挂起。

原理流程

  1. 检查队列是否已满与通道是否可写。
  2. 未满:元素入队,唤醒等待的消费者,返回 static。
  3. 已满:协程挂起,登记为等待生产者,记录超时时刻。
  4. 空位出现/超时/关闭:唤醒并返回数据或抛异常。

代码或图示

<?php
// 文档示例:带超时的写入
use Swow\Channel;
use Swow\ChannelException;

$channel = new Channel(2);
try {
    $channel->push("payload", 1000);
} catch (ChannelException $e) {
    // 区分超时与关闭错误码
    echo $e->getCode();
}

常见误区

  • 省略超时导致永久阻塞:消费者异常退出后生产者可能永远挂起。
  • 把 push 返回值当写入的数据:返回的是通道对象,不是确认回执。

追问

  • 超时单位是秒还是毫秒?答:API 文档标注为毫秒;与 Socket 超时单位一致,具体以当前版本文档为准(待确认)。
  • 无上限通道 push 还会阻塞吗?答:不因容量阻塞;关闭与异常路径仍可能抛错。

06.5.7.4-004 pop() 的阻塞语义与超时参数是什么?

一句话结论

pop(int $timeout): T 从通道取出一个元素;队列空时协程挂起等待数据,$timeout 为毫秒超时;超时或关闭抛 ChannelException,成功返回元素值。

概念解释

pop 在队列非空时取走队首元素并唤醒等待生产者;空队列时挂起等待。超时后抛超时异常;通道关闭后,已排队元素仍可弹出,取完后再 pop 抛关闭异常。返回值类型为通道元素类型 T,业务侧需做类型校验。

原理流程

  1. 检查队列是否有元素与通道是否可读。
  2. 有元素:出队,唤醒等待生产者,返回元素。
  3. 空队列:协程挂起,登记为等待消费者,记录超时时刻。
  4. 数据到达/超时/关闭:唤醒并返回元素或抛异常。

代码或图示

<?php
// 文档示例:带超时的读取
use Swow\Channel;
use Swow\ChannelException;

$channel = new Channel(4);
try {
    $item = $channel->pop(2000);
} catch (ChannelException $e) {
    $item = null;
}

常见误区

  • 关闭通道后以为立即不能 pop:Swow 设计上存量数据仍可取完。
  • 不处理超时异常:消费者会被未捕获异常中断,任务静默丢失。

追问

  • pop 取到的元素类型如何约束?答:Channel 为泛型类 Channel<T>,PHP 运行时不强制元素类型,业务需自行校验。
  • 连续 pop 如何做流式消费?答:循环 pop,配合退出信号或关闭状态判断结束条件。

06.5.7.4-005 满队与空队时操作的挂起条件是什么?

一句话结论

满队时 push 挂起直到有消费者取走元素;空队时 pop 挂起直到有生产者写入元素;挂起协程按等待队列排队唤醒,通道关闭或超时会解除挂起并以异常返回。

概念解释

挂起条件由队列长度与读写等待者共同决定。有界通道满员后新生产者进入等待;消费者取走元素后按等待顺序唤醒生产者。空队列时消费者等待;生产者写入后唤醒消费者。无缓冲通道的挂起条件更严格:必须有对端正在等待才交接。

原理流程

  1. push 时判断 isFull():满则挂起为等待生产者。
  2. pop 时判断 isEmpty():空则挂起为等待消费者。
  3. 每次入队/出队检查对端等待队列,唤醒可继续操作的协程。
  4. 关闭或超时批量解除等待,对应异常码唤醒。

代码或图示

<?php
// 文档示例:状态判断辅助背压决策
use Swow\Channel;

$channel = new Channel(8);
$full = $channel->isFull();
$empty = $channel->isEmpty();
$hasConsumer = $channel->hasConsumers();

常见误区

  • 以为满队 push 直接失败返回:默认是挂起等待,不是立即拒绝。
  • 忽略等待者状态:hasProducers()/hasConsumers() 可用于诊断是否有对端协程存活。

追问

  • 唤醒顺序是 FIFO 吗?答:等待队列调度顺序以扩展实现为准(待确认),业务不应依赖特定唤醒次序。
  • 背压如何体现?答:有界容量 + push 挂起使生产速度受消费速度约束,避免无界积压。

06.5.7.4-006 close() 的语义与已排队数据如何处理?

一句话结论

close() 关闭通道:已排队的值仍可继续 pop 取出;正在等待的协程以错误码 -125 唤醒;对已关闭通道再次 close 抛 ChannelException。

概念解释

关闭是“停止写入”的通知,不是立即销毁队列。生产者不再 push 后关闭通道,消费者取完存量数据即知结束。等待中的读写协程被唤醒并收到关闭错误,避免永久挂起。存量数据保留到被取走,符合“优雅排空”的设计。

原理流程

  1. 生产者完成全部写入后调用 close()。
  2. 通道标记关闭,通知等待中的读写协程。
  3. 消费者继续 pop 取出排队元素,直到队列空。
  4. 关闭后再 pop 抛关闭异常;再 push 抛关闭异常;重复 close 抛异常。

代码或图示

<?php
// 文档示例:关闭后排空消费
use Swow\Channel;

$channel = new Channel(2);
$channel->push("a");
$channel->close();
// 后续消费者仍可 pop 出 "a",队列空后再 pop 抛关闭异常

常见误区

  • close 后立即清空队列:存量数据仍在,需消费完。
  • 忘记 close:消费者可能一直挂起等待不会到来的数据。

追问

  • 错误码 -125 对应什么场景?答:等待协程在通道关闭时被唤醒的错误码;完整码值对照 Swow\ChannelException 与 Swow\Errno 文档(待确认)。
  • 谁负责 close?答:通常由最后一个生产者关闭;多生产者场景需协调关闭时机。

06.5.7.4-007 关闭后再 push/pop 会发生什么?

一句话结论

通道关闭后 push 抛 ChannelException(关闭码 -9758,以文档为准);pop 在存量数据取完后抛关闭异常;对已关闭通道再次调用 close 同样抛异常。

概念解释

关闭后写入路径关闭,读取路径排空。异常而非返回 false,调用方必须用 try/catch 覆盖。判断通道是否可读可写可借助 isReadable()/isWritable(),但状态在并发下会变化,最终仍以异常为准。业务循环应把关闭异常作为正常结束信号处理,而不是报错。

原理流程

  1. close 后通道标记不可写。
  2. push 检测关闭状态,抛关闭异常。
  3. pop 先取存量;队列空后检测关闭,抛关闭异常。
  4. 消费者循环捕获关闭异常后退出,完成排空。

代码或图示

<?php
// 文档示例:排空消费循环
use Swow\Channel;
use Swow\ChannelException;

$channel = new Channel(4);
while (true) {
    try {
        $item = $channel->pop(1000);
    } catch (ChannelException $e) {
        break; // 关闭或超时后退出,按错误码细分处理
    }
}

常见误区

  • 把关闭异常当系统错误上报:它是正常结束信号,应区分错误码后降级处理。
  • 关闭后仍尝试 push 补偿数据:写入必须在 close 之前完成。

追问

  • 如何判断通道是否已关闭?答:isAvailable() 与读写可达性方法结合;是否有直接 closed 方法待确认,以 API 文档为准。
  • 关闭异常与超时异常如何区分?答:读取 getCode() 对照错误码常量;超时 -110、关闭 -9758 等以文档为准。

06.5.7.4-008 Channel 异常码有哪些,如何区分超时与关闭?

一句话结论

ChannelException 覆盖超时与关闭两类失败:超时错误码 -110,关闭相关错误码 -9758(等待唤醒码 -125);通过 getCode() 对照 Swow\Errno 常量区分,业务分支按码值处理。

概念解释

异常码把失败原因结构化:超时表示等待超过限定时间,关闭表示通道已被 close。排障时先按码值分类,再结合日志定位是消费者慢、生产者退出还是通道未正确关闭。码值与常量名以当前版本 API 文档为准,文档示例中不把未核实的码值写死为业务判断依据。

原理流程

  1. catch ChannelException,读取 getCode() 与消息。
  2. 对照 Errno 常量判断超时、关闭等细分场景。
  3. 超时:可重试或降级;关闭:结束消费循环。
  4. 未知码值:记录日志并按保守策略处理,避免静默吞掉。

代码或图示

<?php
// 文档示例:按错误码分支处理
use Swow\Channel;
use Swow\ChannelException;

$channel = new Channel(1);
try {
    $channel->pop(1000);
} catch (ChannelException $e) {
    switch ($e->getCode()) {
        case -110:  // 超时(待确认常量名)
            break;
        case -9758: // 通道关闭(待确认常量名)
            break;
    }
}

常见误区

  • 捕获异常后不读码值:无法区分超时重试与正常关闭。
  • 直接在代码里硬编码数字码:优先使用 Errno 常量,数字仅作对照参考。

追问

  • 错误码常量在哪个类?答:Swow\Errno;完整常量清单对照 API 文档(待确认)。
  • 异常是否携带上游 previous?答:异常链行为以实现为准;记录日志时输出完整栈。

06.5.7.4-009 标准生产者消费者骨架怎么写?

一句话结论

骨架为:创建有界 Channel → 启动若干生产者协程 push 任务 → 启动若干消费者协程 pop 处理 → 生产者结束后 close 通道 → 消费者排空后退出,配合 WaitGroup 汇总等待。

概念解释

生产者消费者解耦生产与消费速度:Channel 缓冲吸收短时波动,容量限制防止积压失控。消费者循环 pop,处理完再取下一条;全部生产者结束后关闭通道,消费者感知关闭后退出。WaitGroup 用于等待两侧协程收敛,主协程不提前结束。

原理流程

  1. 定义任务结构与通道容量。
  2. 生产者协程循环生成任务 push,结束后登记完成。
  3. 消费者协程循环 pop 处理,捕获关闭异常退出。
  4. WaitGroup 等待全部完成,主流程汇总结果。

代码或图示

<?php
// 文档示例:多生产者多消费者骨架
use Swow\Channel;
use Swow\Coroutine;
use Swow\Sync\WaitGroup;

$channel = new Channel(16);
$producerWg = new WaitGroup();
$consumerWg = new WaitGroup();

for ($p = 0; $p < 2; $p++) {
    $producerWg->add();
    Coroutine::run(static function () use ($channel, $producerWg): void {
        for ($i = 0; $i < 5; $i++) {
            $channel->push("task-$i", 1000);
        }
        $producerWg->done();
    });
}
$producerWg->wait(5000);
$channel->close();

for ($c = 0; $c < 2; $c++) {
    $consumerWg->add();
    Coroutine::run(static function () use ($channel, $consumerWg): void {
        // 消费循环,关闭后退出
        $consumerWg->done();
    });
}
$consumerWg->wait(5000);

常见误区

  • 生产者未全部结束就 close:后续生产者 push 会抛关闭异常。
  • 消费者不判断关闭:通道排空后协程挂起,等待超时或泄漏。

追问

  • 消费失败如何重试?答:任务体内部 catch 并重试或推入死信通道;重试次数与退避策略按业务设计。
  • 结果如何回传?答:可再建结果 Channel,消费者处理完 push 结果,汇总协程收集。

06.5.7.4-010 与 Swoole Coroutine Channel 的对照差异是什么?

一句话结论

两者都是协程队列通信,但 Swow Channel 容量支持 0/-1 语义、超时毫秒、关闭后排空、异常唤醒;Swoole Channel 历史上 push/pop 返回布尔或数据、错误经 errCode 获取,容量与关闭语义需按其版本文档对照。

概念解释

对照维度:构造容量范围、阻塞与超时、关闭行为、返回值/异常、状态查询方法。迁移时不能按同名类直接替换:错误处理从返回值判断改为 catch 异常;超时单位核对;关闭后存量数据行为核对。Swoole 内部机制只作引用,本章节不展开。

原理流程

  1. 列出原代码 Channel 构造、push/pop、close 与错误判断点。
  2. 对照 Swow 文档确认容量、超时、异常码语义。
  3. 改写错误分支:=== false → catch (ChannelException)。
  4. 压测验证背压、排空与超时路径。

代码或图示

对照要点
容量:Swoole 容量约束        ↔  Swow 0 / 正数 / -1
失败:返回 false + errCode   ↔  抛 ChannelException + getCode()
关闭:存量行为与唤醒方式      ↔  close 后排空,等待者错误码唤醒

常见误区

  • 以为同名 API 签名一致:参数顺序、超时单位、返回类型都需核对。
  • 迁移后保留 errCode 读取代码:Swow 侧错误信息从异常对象获取。

追问

  • 详细迁移对照在哪一批?答:06.5.7.11 与 Swoole 的迁移对照(规划中)。
  • Swoole Channel 细节看哪里?答:本仓库 06.5.6-Swoole 章节。

06.5.7.4-011 Channel 中可以传递哪些类型的值?

一句话结论

Channel 元素类型为泛型 T,可传递标量、数组、对象等 PHP 变量;资源句柄与跨进程对象的传递约束需谨慎对待,对象在通道间传递的是引用,可变对象仍需同步保护。

概念解释

PHP 变量在协程间共享同一 Zend 堆,对象入队传递的是引用拷贝。不可变数据(标量、只读数组)传输安全;可变对象被多个协程访问时仍需锁或消息化处理。长生命周期资源(连接、句柄)不适合作为普通消息来回传递,应明确归属与归还路径。

原理流程

  1. 消息设计为值对象:标量数组或只读对象,减少共享可变状态。
  2. 对象入队前确认接收方独占使用,避免并发改写。
  3. 资源句柄通过归属约定传递,不用 Channel 做通用资源池。
  4. 消费侧校验元素类型,防御非法消息。

代码或图示

<?php
// 文档示例:值对象消息入队
use Swow\Channel;

final class TaskMessage
{
    public function __construct(public readonly int $taskId, public readonly string $payload)
    {
    }
}

$channel = new Channel(8);
$channel->push(new TaskMessage(1, "body"));

常见误区

  • 把数据库连接对象当消息传递:连接归属与借还应走池化管理。
  • 在消息对象上留下可变状态:多个消费者读取到同一引用可能被互相改写。

追问

  • 闭包能入队吗?答:技术上可传递 callable,但跨协程执行闭包涉及上下文与绑定,不建议作为常规消息格式;以实现行为实测为准(待确认)。
  • 大对象入队有什么成本?答:对象引用传递无深拷贝,但堆内存被队列持有期间不会释放,需控制积压。

06.5.7.4-012 如何查询 Channel 当前长度与读写可达性?

一句话结论

可用方法包括 getCapacity()(容量)、getLength()(当前长度)、isEmpty()、isFull()、isReadable()、isWritable()、hasConsumers()、hasProducers()、isAvailable(),用于监控背压与诊断等待者状态。

概念解释

状态方法是观测入口:长度与容量判断积压程度;readable/writable 判断当前是否可操作;hasConsumers/hasProducers 帮助识别“只有生产没有消费”的泄漏型通道。注意这些方法返回的是调用瞬间快照,并发下状态随即变化,不能作为同步判断的唯一依据。

原理流程

  1. 监控协程周期性读取容量与长度,计算积压水位。
  2. 诊断无消费问题时检查 hasConsumers()。
  3. 判断读写前参考 isReadable()/isWritable(),最终仍以 push/pop 异常为准。
  4. 快照数据写入指标或日志,辅助容量配置调整。

代码或图示

<?php
// 文档示例:通道水位观测
use Swow\Channel;

$channel = new Channel(16);
$capacity = $channel->getCapacity();
$length = $channel->getLength();
$readable = $channel->isReadable();
$writable = $channel->isWritable();

常见误区

  • 用 isFull() 跳过 push 判断:满队仍需走 push 阻塞或超时流程。
  • 依据 hasProducers() 判断任务是否结束:生产者退出不等于队列排空,要取完存量。

追问

  • 监控指标怎么定?答:长度水位、等待生产者/消费者数量、积压时长;具体指标名按项目规范。
  • 这些方法在关闭通道后返回什么?答:关闭后的状态取值以实现为准(待确认),不可读/不可写分支结合异常判断。

06.5.7.4-013 多生产者多消费者下的行为是什么?

一句话结论

Channel 内部协调多个等待协程:多个生产者写入同一队列,多个消费者竞争取出元素,每条元素只被一个消费者取得;等待协程按内部排队机制唤醒,业务不应假设固定分配顺序。

概念解释

多消费者竞争模型下,一条消息只送达一个消费者,适合任务分发;需要广播给所有消费者时,应为每个消费者建独立通道。生产者侧多个协程并发 push,队列满时各自挂起等待空位。任务分配是否均衡取决于调度顺序与处理耗时,不能按“轮流”假设。

原理流程

  1. 启动 N 个生产者向同一通道 push。
  2. 启动 M 个消费者循环 pop,竞争获取任务。
  3. 入队/出队时通道唤醒对应等待者。
  4. 生产者全部结束后 close,消费者排空退出。

代码或图示

<?php
// 文档示例:竞争消费模型
use Swow\Channel;
use Swow\Coroutine;

$channel = new Channel(32);
for ($i = 0; $i < 3; $i++) {
    Coroutine::run(static function () use ($channel): void {
        while (true) {
            $task = $channel->pop(1000);
            // 独占处理该任务
        }
    });
}

常见误区

  • 期望一条消息被所有消费者收到:竞争通道是一对一取走,广播需多通道。
  • 假设消费者按序号均分任务:实际分配受调度与处理耗时影响。

追问

  • 广播如何实现?答:维护消费者通道列表,生产者向每个通道 push 同一消息;成员变更需同步保护。
  • 多生产者关闭时机怎么协调?答:用 WaitGroup 等全部生产者完成后再由汇总协程 close。

06.5.7.4-014 容量为 0 的无缓冲通道(会合式)怎么用?

一句话结论

new Channel(0) 不暂存元素:push 必须等待有消费者正在 pop 才交接完成,反之亦然;适合做严格的直接同步与握手,不适合吸收生产消费速度差。

概念解释

无缓冲通道没有队列容量,读写双方在通道上会合后直接交接元素。语义类似 Go 的 unbuffered channel。需要削峰填谷的场景必须用正容量;无缓冲通道上的双方都会阻塞到对端就位,超时控制尤其重要。

原理流程

  1. 构造容量 0 的通道。
  2. 消费者先 pop 等待,或生产者先 push 等待。
  3. 对端到达后直接交接,元素不经过队列暂存。
  4. 任一方缺席超时,对应操作抛超时异常。

代码或图示

<?php
// 文档示例:会合式通道握手
use Swow\Channel;

$handshake = new Channel(0);
// 一侧等待信号,另一侧直接交接
$handshake->push("ready", 1000);
$signal = $handshake->pop(1000);

常见误区

  • 用 0 容量做任务缓冲:速度差会直接表现为双方阻塞。
  • 忘记超时:对端协程异常退出后,等待方永久挂起。

追问

  • 无缓冲与 -1 的选择依据?答:需要严格同步用 0;允许积压用有界正数;无界仅在可确认内存安全时使用。
  • 会合交接传对象还是值?答:同样按 PHP 引用计数规则传递,对象为引用。

06.5.7.4-015 Channel 泄漏的典型场景与排查方法是什么?

一句话结论

Channel 泄漏表现为通道对象被长期持有但无人生产或消费、等待协程永久挂起;排查通过 getAll() 找挂起协程、读调用栈定位等待通道,结合 hasConsumers()/hasProducers() 判断对端是否缺失。

概念解释

常见成因:消费者协程提前退出但生产者仍 push;生产者忘记 close,消费者空等;通道作为单例长期持有任务引用;协程异常退出未清理通道引用。泄漏占用协程与内存,长期运行后表现为协程数增长、内存上涨。排查先看挂起点在哪个 push/pop,再追对端协程生命周期。

原理流程

  1. 监控协程数量与通道长度,发现持续增长。
  2. 遍历 getAll(),筛选 waiting 且栈在 Channel 操作上的协程。
  3. 读取通道对象状态:长度、是否有等待对端。
  4. 回溯通道创建处与持有引用,定位未关闭/未消费路径。

代码或图示

<?php
// 文档示例:挂起通道协程快照
use Swow\Coroutine;

foreach (Coroutine::getAll() as $id => $co) {
    if ($co->getStateName() === "waiting") {
        echo $id, PHP_EOL;
        echo $co->getTraceAsString(0, 5, 0), PHP_EOL;
    }
}

常见误区

  • 只看通道长度不看等待者:长度为 0 也可能有消费者永久等待。
  • 通道挂在单例上不释放:请求结束后通道与消息仍被持有。

追问

  • 如何在设计上防泄漏?答:明确通道所有权、固定关闭责任方、所有等待操作带超时、协程退出清理引用。
  • 泄漏定位工具?答:SDB 调试器与协程快照;见调试观测批次 06.5.7.13。

06.5.7.4-016 协程死锁在 Channel 上的典型成因是什么?

一句话结论

死锁指全部业务协程都阻塞在通道操作上、没有就绪协程可推进:典型成因包括只有生产者没有消费者、只有消费者没有生产者、容量与任务循环互相等待、闭环依赖同一通道。

概念解释

调度器在无就绪协程时进入死锁状态。Channel 上的死锁多为结构错误:任务 A 等通道数据,任务 B 等 A 释放资源;或生产者被满队阻塞而消费者已全部退出。排查先画清生产/消费依赖图,确认每个等待都有对应唤醒方。Swow 提供死锁处理器注册钩子介入此类场景。

原理流程

  1. 列出每个协程等待的通道与等待方向。
  2. 检查是否存在闭环:A 等 B 的数据,B 等 A 的资源。
  3. 确认消费者/生产者协程存活且会被调度。
  4. 必要时注册 Coroutine::registerDeadlockHandler() 上报死锁现场。

代码或图示

<?php
// 文档示例:死锁处理器注册骨架
use Swow\Coroutine;

Coroutine::registerDeadlockHandler(static function (): void {
    // 记录现场快照:协程列表、通道状态、调用栈
    echo "deadlock detected", PHP_EOL;
});

常见误区

  • 给所有等待加超时仍不排查结构:超时只是兜底,根因是依赖闭环。
  • 在死锁回调里做复杂阻塞操作:回调应快速记录现场后退出。

追问

  • 死锁处理器触发条件是什么?答:调度器判定无可运行协程时触发;具体语义以 API 文档为准(待确认)。
  • 如何复现死锁用例?答:隔离脚本内构造单生产者单消费者闭环,配合 getAll 快照观察。

06.5.7.4-017 Channel 与普通数组/全局队列相比,并发安全保证是什么?

一句话结论

普通 PHP 数组在多协程间并发读写没有同步保护,交替调度下会产生读写竞争;Channel 内部处理排队、挂起与唤醒,访问元素无需业务再加锁,是协程间传递数据的安全设施。

概念解释

单线程协作调度下,竞争发生在“让出点前后”:协程 A 读到数组未写完的状态,或两个协程交替 append 导致顺序错乱。Channel 把入队/出队做成原子等待点,元素同一时刻只由一方取出。共享可变数组仍需 Mutex 等同步设施保护;能改走消息传递就不要共享可变结构。

原理流程

  1. 识别协程间需要交换的数据。
  2. 优先设计为 Channel 消息,按值或不可变对象传递。
  3. 必须共享的可变结构用锁保护临界区。
  4. 压测并发交替调度场景,检查数据一致性。

代码或图示

<?php
// 错误示范(文档示例):并发写普通数组无保护
use Swow\Coroutine;

$list = [];
for ($i = 0; $i < 10; $i++) {
    Coroutine::run(static function () use ($list, $i): void {
        $list[] = $i; // 存在竞争与顺序不确定风险
    });
}

常见误区

  • 以为单线程就没有竞争:协作调度在让出点交错执行,共享可变状态同样不安全。
  • 用 Channel 传递可变对象后又并发改写对象:通道安全不保护对象内部状态。

追问

  • 有哪些锁设施?答:Swow\Mutex、Swow\Semaphore、Swow\Futex 等;用法见协程安全主题 06.5.7.8。
  • 原子计数器怎么做?答:优先 Channel 传递计数变更,或使用原子/锁设施;不要裸改静态变量。

06.5.7.4-018 协程退出后 Channel 上的残留引用如何处理?

一句话结论

协程退出不会自动关闭它创建的 Channel;若通道对象仍被外部引用,队列元素与等待状态继续存在。需要显式 close 并丢弃引用,使元素与协程等待者随引用计数释放。

概念解释

Channel 生命周期由持有它的对象/变量决定,不随某个生产者或消费者协程退出而销毁。任务协程异常退出后,通道可能残留已 push 的消息;其他等待协程仍挂在上面。设计时明确通道所有权:谁创建、谁关闭、谁持有最后引用,避免常驻进程内累积废弃通道。

原理流程

  1. 定义通道所有权与关闭责任方。
  2. 协程异常路径也要执行 close 或通知汇总方关闭。
  3. 任务结束后解除外部引用,让通道与元素按引用计数回收。
  4. 观测通道数量与队列长度,发现残留后回溯持有链。

代码或图示

<?php
// 文档示例:异常路径关闭通道
use Swow\Channel;
use Swow\ChannelException;

$channel = new Channel(4);
try {
    $channel->push("task", 1000);
} catch (ChannelException $e) {
    $channel->close();
} finally {
    // 通道引用在作用域结束后释放
}

常见误区

  • 以为协程结束其创建的通道自动销毁:通道是独立对象,引用决定生命周期。
  • 把通道塞进全局静态表长期不清理:废弃消息持续占用内存。

追问

  • 连接/请求级通道存哪里?答:协程局部变量或请求上下文对象,随请求结束释放,不挂全局容器。
  • 残留消息如何排空?答:定位持有方后按需 pop 取完或 close 唤醒等待者。

06.5.7.4-019 如何用 Channel 实现一对多通知?

一句话结论

竞争通道一条消息只送达一个消费者;一对多广播需要为每个订阅者维护独立 Channel,通知方遍历通道列表逐条 push;订阅者集合本身的增删需同步保护。

概念解释

常见退出通知、配置变更广播场景:一个事件要通知多个协程。实现方式是订阅时注册自己的通道到订阅表,发布时遍历推送。通道列表的读写发生在不同协程,需要 Mutex 保护或通过专门的管理协程串行化。订阅者退出时注销通道,避免向死通道推送堆积。

原理流程

  1. 维护订阅者通道列表与保护锁。
  2. 订阅协程创建个人通道并登记。
  3. 发布协程遍历列表 push 通知,各自带超时。
  4. 订阅者退出时注销通道并关闭。

代码或图示

<?php
// 文档示例:广播通道表骨架
use Swow\Channel;
use Swow\Mutex;

$mutex = new Mutex();
$subscribers = [];

function broadcast(string $message) use ($mutex, $subscribers): void
{
    $mutex->lock();
    try {
        foreach ($subscribers as $ch) {
            $ch->push($message, 1000);
        }
    } finally {
        $mutex->unlock();
    }
}

常见误区

  • 用单个通道指望多消费者都收到:竞争模型下每条消息只被取走一次。
  • 遍历订阅表不加保护:登记与遍历交错会产生数组竞争。

追问

  • Mutex 用法细节?答:见 06.5.7.8 协程安全与状态管理;锁粒度与持锁时间需控制。
  • 广播顺序有保证吗?答:遍历顺序按登记结构,不代表订阅者处理顺序;顺序要求需单独设计。

06.5.7.4-020 在非协程上下文使用 Channel 有什么风险?

一句话结论

Channel 的阻塞等待依赖协程调度:在非协程上下文(如主脚本未进入协程、或未 hook 的同步环境)调用会挂起当前执行流且无法被调度唤醒,行为与协程内使用不同,应先确认调用点处于协程上下文。

概念解释

push/pop 在条件不满足时发生上下文切换,把协程挂起到等待队列。如果当前执行流不是协程,调度器没有可恢复的上下文,阻塞可能退化为同步卡住或直接抛错。框架回调、协程入口闭包内属于协程上下文;全局初始化函数、未包裹的脚本主体需特别确认。

原理流程

  1. 确认调用点:Coroutine::getCurrent() 是否可正常返回协程对象。
  2. 协程上下文内使用 Channel,等待由调度器管理。
  3. 非上下文场景改为同步队列结构或先 run() 进入协程。
  4. 框架组件内使用时核对回调执行环境。

代码或图示

<?php
// 文档示例:进入协程上下文后再使用 Channel
use Swow\Channel;
use Swow\Coroutine;

Coroutine::run(static function (): void {
    $channel = new Channel(4);
    $channel->push("ok", 1000);
    $item = $channel->pop(1000);
});

常见误区

  • 在容器构造、静态初始化阶段直接操作 Channel:此时可能尚无调度上下文。
  • 假设所有回调都运行在协程内:第三方库同步回调环境需逐个确认。

追问

  • 如何判断当前是否在协程上下文?答:调用 Coroutine::getCurrent() 并捕获异常;具体判断方法以 API 文档为准(待确认)。
  • 非协程场景如何做并发收集?答:先进入主协程或 Server 回调,在协程上下文内使用 Channel/Sync 设施。