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

06.5.7.8 协程安全与状态管理

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

06.5.7.8-001 什么是协程安全?单线程协程模型下为什么还会有竞争?

一句话结论

协程安全指代码在多协程交替调度下共享状态不产生错乱;虽然单线程执行,但协程在让出点交错运行,读写同一可变状态仍会产生竞争,与多线程竞争同理需要同步或消息传递。

概念解释

单线程不等于串行到底:协程在 IO 等待、同步挂起点让出,其他协程插入执行。若两个协程先后读写同一变量、数组或对象属性,调度交错可能读到中间状态。竞争不依赖 OS 线程,而依赖“执行流在让出点交错”。协程安全编码的核心是:共享可变状态加保护,或通过 Channel 传值避免共享。

原理流程

  1. 协程 A 读取共享状态,遇到让出点挂起。
  2. 协程 B 修改同一共享状态后完成。
  3. 协程 A 恢复后基于过期状态继续操作。
  4. 结果错乱:计数不准、数据覆盖、条件判断失效。

代码或图示

<?php
// 错误示范(文档示例):交替调度下并发累加无保护
use Swow\Coroutine;

$counter = 0;
for ($i = 0; $i < 10; $i++) {
    Coroutine::run(static function () use (&$counter): void {
        $counter++; // 存在交错竞争风险
    });
}

常见误区

  • 以为单线程就不需要同步:让出点交错使共享读写同样不安全。
  • 把协程安全等同于线程安全:两者竞争模型相似,但同步设施是协程级的。

追问

  • 哪些状态最容易出问题?答:静态变量、单例属性、全局数组、缓存对象、连接对象。
  • 协程安全编码清单见哪一题?答:06.5.7.8-019。

06.5.7.8-002 全局变量与静态变量在协程间的竞争问题是什么?

一句话结论

全局变量与静态属性在进程内所有协程共享,请求间不自动隔离;把请求态数据写进去会被其他协程读到残留值,并发读写还会产生竞争,常驻服务中必须避免。

概念解释

FPM 每请求销毁进程,全局/静态状态天然不跨请求;常驻进程中这些变量长期存活。多个请求协程并发读写同一静态变量,既可能读到上一请求残留,也可能在交错调度下互相覆盖。进程级配置、不可变字典可以放静态;请求态(用户 ID、请求参数、临时计数)禁止放全局/静态。

原理流程

  1. 识别变量用途:进程级常量配置 vs 请求态数据。
  2. 请求态数据放入协程局部变量或上下文对象。
  3. 必须共享的进程级状态评估并发访问路径。
  4. 评审代码扫描 global、static 与单例属性中的请求字段。

代码或图示

<?php
// 错误示范(文档示例):静态属性保存请求态
class SessionHolder
{
    public static int $userId = 0; // 禁止:跨协程串数据
}

function login(int $userId): void
{
    SessionHolder::$userId = $userId;
}

常见误区

  • 以为静态变量每请求重置:常驻进程内不重置。
  • 只读静态配置也担心竞争:不可变配置并发读是安全的,风险在写入与请求态存放。

追问

  • 框架上下文如何隔离?答:框架按协程 ID 或对象引用维护请求上下文;Swow 侧优先显式传参,见 06.5.7.8-004。
  • 静态初始化什么时候执行?答:类加载/首次访问时,属于进程级一次性初始化,不能读取请求参数。

06.5.7.8-003 单例对象属性存放请求态数据有什么风险?

一句话结论

单例在进程内长期存活,其属性被所有协程共享;把当前用户、请求参数、临时结果写入单例属性,会在并发下互相覆盖、跨请求串数据,是常驻模型最高频的事故来源。

概念解释

容器单例、工具类实例通常只应持有进程级依赖(配置、日志器、连接池)。请求态字段挂到单例属性上后,协程 A 写入未及读取,协程 B 覆盖,A 读到 B 的数据。排查表现为“偶发串用户、串订单”,并发越高越难复现。修复方式是请求数据走参数与上下文对象,单例只放无状态服务与进程级资源。

原理流程

  1. 盘点单例类属性:区分依赖引用与可变状态。
  2. 请求态字段从单例移除,改为方法参数传入。
  3. 必须保留的状态放入请求上下文对象,随协程回收。
  4. 并发用例覆盖多协程同时调用同一单例。

代码或图示

<?php
// 错误示范(文档示例):单例属性缓存请求用户
final class OrderService
{
    private int $currentUserId = 0; // 请求态,禁止挂单例

    public function setUser(int $userId): void
    {
        $this->currentUserId = $userId;
    }
}

常见误区

  • 单例只在一个请求里用就放心存状态:常驻进程中后续协程复用同一实例。
  • 以为属性私有就安全:私有只限制访问权限,不隔离协程。

追问

  • 单例里能存什么?答:无状态逻辑、进程级配置、连接池/客户端引用;不存请求态可变字段。
  • 串数据故障怎么排查?答:见 06.5.7.8-017。

06.5.7.8-004 协程上下文不可用时,有哪些替代方案?

一句话结论

没有现成上下文容器时,替代方案按优先级:方法参数显式传递 → 协程私有上下文对象封装请求态 → 派生协程时显式复制所需字段;避免依赖隐式全局或静态存储。

概念解释

上下文的作用是跨函数调用链传递请求标识、用户信息、追踪 ID。Swow 不假设存在全局 Context 门面(待确认),工程上显式传参最清晰:入口构造上下文对象,沿调用链作为参数传递。派生新协程时,父协程局部变量不会自动带入,需要在闭包 use 中显式复制字段。

原理流程

  1. 入口收集请求信息,构造不可变上下文对象。
  2. 业务方法签名接收上下文参数,不读全局静态。
  3. 派生协程时闭包 use 所需字段,显式传递。
  4. 上下文随协程结束回收,不挂常驻容器。

代码或图示

<?php
// 文档示例:上下文对象显式传递
final class RequestContext
{
    public function __construct(public readonly int $userId, public readonly string $traceId)
    {
    }
}

function handle(RequestContext $ctx): array
{
    return ["uid" => $ctx->userId, "trace" => $ctx->traceId];
}

常见误区

  • 派生协程后读父协程局部变量:局部变量不自动继承。
  • 上下文对象内部留可变字段被多协程改写:字段设计为只读或加保护。

追问

  • 框架提供上下文封装时怎么对接?答:核对其隔离键(协程 ID/对象引用)与跨协程复制规则,不假设与 Swoole Context 行为一致。
  • 大对象上下文怎么传?答:传引用,避免整份拷贝;对象内部状态按不可变或同步规则处理。

06.5.7.8-005 数据库、Redis 等连接资源的归属规则是什么?

一句话结论

连接对象必须有明确归属:同一时刻由一个协程独占使用;非协程安全的客户端不能在多协程间并发调用,池化连接借出后独占、用完归还;连接归属不清是串包与超时的常见根因。

概念解释

连接内部有缓冲区与请求/响应状态,并发复用会导致响应串包。协程安全客户端通常内部处理排队;非安全客户端必须配合连接池借还。连接归属分三类:请求内独占、池化借还、长生命周期专属。归还前重置会话状态(事务、select 库、订阅状态),避免下一协程读到残留。

原理流程

  1. 确认客户端协程安全性与连接复用规则。
  2. 池化场景:借出连接 → 请求内独占使用 → finally 归还。
  3. 归还前清理会话状态,异常路径同样归还。
  4. 池耗尽时按等待策略排队或快速失败,不新建裸连接并发共享。

代码或图示

<?php
// 文档示例:连接借还骨架(客户端类型按项目实际替换)
use Swow\Coroutine;
use Swow\Sync\WaitGroup;

$wg = new WaitGroup();
$wg->add(2);
foreach ([1, 2] as $i) {
    Coroutine::run(static function () use ($wg): void {
        $connection = acquireConnection(); // 从池借出
        try {
            // 独占使用连接
        } finally {
            releaseConnection($connection); // 归还并重置状态
            $wg->done();
        }
    });
}
$wg->wait(5000);

常见误区

  • 把单例连接对象给多个协程并发调用:非安全客户端响应串包。
  • 异常退出不归还连接:池逐步耗尽,新请求拿不到连接。

追问

  • 如何判断客户端是否协程安全?答:查官方说明 + 并发压测观察串包与阻塞;不确定标注待确认。
  • 事务跨协程可以吗?答:事务绑定连接归属,不能拆分到多协程并发执行同一事务。

06.5.7.8-006 资源句柄在协程退出后如何保证关闭?

一句话结论

文件句柄、网络连接、缓冲、锁等资源通过 defer 或 finally 在协程退出路径统一释放;异常、提前 return、超时分支都要覆盖,避免协程退出后句柄残留占用 fd 与内存。

概念解释

协程退出路径不止正常返回:未捕获异常、被 kill、超时中断。资源释放必须挂在所有出口上。defer 跟随函数帧结束逆序执行,finally 针对 try 块;连接归还与句柄关闭优先放在清理路径。对象析构是最后兜底,不能替代显式清理。

原理流程

  1. 获取资源后立即登记清理动作(defer/finally)。
  2. 业务正常返回或抛异常,清理路径被触发。
  3. 归还连接、关闭句柄、释放缓冲与锁。
  4. 压测异常路径确认资源计数回到基线。

代码或图示

<?php
// 文档示例:清理动作覆盖异常路径
use function Swow\defer;

function process(): void
{
    $resource = openResource();
    defer(static function () use ($resource): void {
        closeResource($resource);
    });
    // 业务与 IO,return 或异常都会触发 defer
}

常见误区

  • 清理只写在成功分支:异常退出时句柄泄漏。
  • 依赖析构函数兜底:析构时机不可控,fd 可能长期占用。

追问

  • defer 与 finally 怎么选?答:跨多层函数帧清理用 defer;单 try 块内资源用 finally。
  • 资源泄漏如何量化?答:对比协程数、fd 数、连接池占用在压测前后的基线变化。

06.5.7.8-007 defer 在协程退出清理中扮演什么角色?

一句话结论

Swow\defer(callable) 在当前函数帧结束时逆序执行清理任务,覆盖正常返回与异常退出;是协程内做资源归还、状态复位的首选设施,与协程退出流程配合保证清理不遗漏。

概念解释

defer 注册时不执行,帧结束时按注册逆序跑。逆序符合栈式资源释放:后获取的资源先释放。defer 跟随函数帧而非整个协程生命周期;函数返回后即执行。清理动作应轻量,不在 defer 内做阻塞等待或新的复杂调度。

原理流程

  1. 获取资源后注册对应 defer 清理闭包。
  2. 业务代码执行,可能多段 return 或抛异常。
  3. 函数帧结束,按逆序执行所有 defer。
  4. 清理完成后帧销毁,协程继续退出流程。

代码或图示

<?php
// 文档示例:逆序清理注册
use function Swow\defer;

function run(): void
{
    defer(static function (): void {
        echo "release second";
    });
    defer(static function (): void {
        echo "release first";
    });
}

常见误区

  • defer 内再访问已不可用资源:清理顺序需保证依赖关系。
  • defer 中抛异常未处理:清理阶段异常可能影响后续 defer,关键动作内部容错。

追问

  • defer 执行时机细节见哪一页?答:06.5.7.3-016。
  • 主作用域 defer 何时跑?答:请求关闭阶段;以文档描述为准。

06.5.7.8-008 共享可变状态的保护手段有哪些?

一句话结论

保护手段按优先级:消息传递(Channel 传值,避免共享)→ 独立副本 → 互斥锁(Swow\Mutex)→ 信号量(Swow\Semaphore)/原子设施(Swow\Futex);临界区尽量短小,持锁期间不做阻塞 IO。

概念解释

能不共享就不共享:Channel 把数据交给独占方,从根上消除竞争。必须共享时,Mutex 串行化临界区;Semaphore 控制并发访问额度;Futex 等底层设施用于自同步结构。锁粒度过大并发下降,过小保护不全。临界区内只做内存操作,网络/等待调用放到锁外。

原理流程

  1. 评估状态是否可以改为消息传递或每协程私有。
  2. 必须共享:识别临界区读写集合。
  3. 选择 Mutex/Semaphore 保护,封装加锁解锁对。
  4. 压测并发竞争,检查死锁与持锁时长。

代码或图示

<?php
// 文档示例:Mutex 保护共享计数
use Swow\Mutex;

$mutex = new Mutex();
$count = 0;
// 临界区:
$mutex->lock();
try {
    $count++;
} finally {
    $mutex->unlock();
}

常见误区

  • 持锁期间调用 Channel pop/IO:锁长时间不释放,其他协程排队阻塞。
  • 多个锁获取顺序不一致:临界区交叉可能死锁,统一加锁顺序。

追问

  • Mutex 与 Buffer 锁区别?答:Mutex 是通用互斥设施;Buffer 锁绑定缓冲对象。
  • 锁设施 API 细节?答:Swow\Mutex、Swow\Semaphore、Swow\Futex 方法签名以 API 文档为准(待确认)。

06.5.7.8-009 日志、缓存、HTTP 客户端的协程安全性如何判断?

一句话结论

判断依据:客户端内部连接/状态是否按协程隔离、并发调用是否串行排队、官方是否声明协程安全;未确认前按非安全处理,通过池化或独占使用规避,不在多协程间共享未加保护的实例。

概念解释

日志器通常内部写通道或加锁,较易做到协程安全;缓存/HTTP 客户端持有连接与缓冲区,风险更高。判断路径:官方文档协程适配说明 → 源码连接管理方式 → 并发压测观察串包、错乱与阻塞。框架提供的客户端一般已处理池化,自研或第三方库需单独验证。

原理流程

  1. 查文档与依赖说明是否声明协程安全。
  2. 源码层面看连接对象是否每协程/每请求独占。
  3. 并发压测:多协程同时调用,检查结果错乱与事件循环阻塞。
  4. 未确认的客户端按独占/池化使用,不做全局共享单例调用。

代码或图示

# 盘点项目中直接使用的客户端与扩展(示例命令)
composer show --tree
php -m

常见误区

  • 客户端方法是普通 PHP 函数就以为安全:内部可能持有共享连接状态。
  • 日志打印本身阻塞事件循环:核对日志写盘/远程上报是否协程化。

追问

  • 全局单例客户端可以用吗?答:协程安全的无状态客户端可以;持有连接状态的需走池化。
  • 结果错乱如何复现?答:并发交替调用同一实例,比对响应与请求标识是否对应。

06.5.7.8-010 异常路径下的资源回收要点是什么?

一句话结论

异常路径必须保证:连接归还、句柄关闭、缓冲清理、锁释放、计数通知(done/解除引用)都执行;统一在 finally/defer 中处理,异常记录后再走降级或重试,不留半回收状态。

概念解释

正常路径资源回收容易写,异常路径最容易漏。每获取一类资源就配对一个清理动作;catch 只负责记录与降级,finally/defer 负责释放。异常后共享状态可能处于中间态,需要复位或丢弃对象重建,不能直接复用脏实例。

原理流程

  1. 资源获取后立即配对清理注册。
  2. catch 捕获异常:记录标识、消息、栈,决定重试/降级。
  3. finally/defer 按逆序释放资源与通知同步设施。
  4. 校验资源计数回到基线,脏对象不再复用。

代码或图示

<?php
// 文档示例:异常路径资源回收骨架
use Swow\Sync\WaitGroup;

$wg = new WaitGroup();
$wg->add(1);
try {
    $conn = acquire();
    // 使用 $conn
} catch (\Throwable $e) {
    // 记录异常
} finally {
    release($conn ?? null);
    $wg->done();
}

常见误区

  • catch 后直接 return 跳过 finally 之后的清理:清理必须在 finally 内。
  • 异常后复用未复位的连接:事务、会话状态残留污染下一使用方。

追问

  • 异常处理专题在哪一批?答:06.5.7.10 错误处理与异常传播(规划中)。
  • 如何测试异常回收?答:注入异常用例,压测后检查连接池、fd 与协程数是否回落。

06.5.7.8-011 请求态数据应该放在哪里?

一句话结论

请求态数据放在协程局部变量或请求上下文对象中,随协程回收;禁止写入全局/静态/单例属性;跨函数通过参数传递,跨协程通过 Channel 或显式复制上下文字段传递。

概念解释

请求态包括:当前用户、请求参数、追踪 ID、单次计算结果、临时缓存。生命周期与一次请求一致,协程结束即应回收。存放位置按调用范围选择:本函数内局部变量;跨函数上下文对象;跨协程消息传递。进程级配置、不可变字典才放静态/单例。

原理流程

  1. 入口构造请求上下文对象,收集请求态字段。
  2. 调用链以参数形式传递上下文。
  3. 派生协程显式复制所需字段,不依赖隐式继承。
  4. 协程结束,局部上下文随栈回收,无残留。

代码或图示

<?php
// 文档示例:请求上下文随协程回收
final class RequestContext
{
    public function __construct(public readonly int $userId, public readonly string $traceId)
    {
    }
}

function process(RequestContext $ctx): void
{
    $localResult = compute($ctx);
    // $localResult 与 $ctx 随本协程结束回收
}

常见误区

  • 为方便把上下文塞全局容器:多协程并发时互相覆盖。
  • 上下文对象长期缓存到单例:请求结束后残留被下一请求读到。

追问

  • 上下文需要跨异步回调传递怎么办?答:闭包 use 复制字段,或通过 Channel 携带上下文标识。
  • 框架上下文与自研上下文如何共存?答:以框架上下文为准接入,避免两套请求态存储。

06.5.7.8-012 常驻内存下静态初始化与单例缓存有哪些注意点?

一句话结论

静态初始化只做进程级一次性工作(配置加载、不可变字典);单例缓存只能缓存进程级可复用数据,缓存请求态结果会跨请求串数据;常驻期间注意缓存失效与内存增长。

概念解释

进程启动后类静态属性与单例一直存在:第一次请求写入的值后续请求都能读到。适合缓存:配置、路由表、字典、编译后的不可变结构。不适合:用户数据、请求临时结果、带会话状态的客户端。缓存失效策略要考虑常驻生命周期,不能假设每请求重建。

原理流程

  1. 启动阶段加载进程级配置与不可变资源。
  2. 单例只持有无状态服务与进程级依赖。
  3. 缓存数据标注生命周期与失效条件,避免无限增长。
  4. 代码评审区分“可缓存”与“请求态”两类数据。

代码或图示

<?php
// 文档示例:进程级不可变配置缓存(正确方向)
final class AppConfig
{
    /** @var array<string,string> */
    private static array $dict = [];

    public static function init(array $dict): void
    {
        self::$dict = $dict; // 启动阶段一次性加载
    }
}

常见误区

  • 单例缓存接口返回的用户数据:后续请求读到上一用户结果。
  • 静态数组只增不清:常驻内存随时间持续上涨。

追问

  • 配置热更新怎么做?答:重新加载机制或进程重启;常驻模型不依赖每请求重读。
  • 缓存穿透/击穿防护在哪类文档?答:缓存设计见数据库与存储、高阶架构分册。

06.5.7.8-013 协程 ID 作为上下文键的用法与风险是什么?

一句话结论

协程 ID 可作为日志关联与上下文隔离的键,配合 Coroutine::getCurrent() 获取;风险是 ID 不适合做长期持久句柄,协程退出后反查为空,且派生协程需要显式传递上下文标识而非依赖 ID 自动关联。

概念解释

日志带 CID 便于串联同一协程的调用链。若框架按 CID 存上下文,派生新协程时上下文不会自动继承,需要把标识与字段显式带入。ID 分配与回收规则以扩展实现为准,退出后 Coroutine::get($id) 可能返回 null。不要把 CID 写入长期存储作为业务标识。

原理流程

  1. 协程入口 getCurrent()->getId() 取 CID 写入日志上下文。
  2. 上下文存储按 CID 隔离存取,派生协程显式复制所需字段。
  3. 协程退出清理对应上下文条目,避免映射表残留。
  4. 跨进程日志关联使用业务追踪 ID,不使用 CID。

代码或图示

<?php
// 文档示例:日志携带协程 ID
use Swow\Coroutine;

function logWithCid(string $message): void
{
    $cid = Coroutine::getCurrent()->getId();
    echo "[cid={$cid}] {$message}", PHP_EOL;
}

常见误区

  • 用 CID 做跨请求业务主键:ID 会回收复用,不保证长期唯一。
  • 派生协程后按父 CID 取上下文:新协程有自己的 ID,映射不自动继承。

追问

  • ID 复用规则?答:待确认;以扩展实现与文档为准,排障时结合起止时间判断。
  • 上下文映射表谁清理?答:框架上下文组件或业务请求结束路径;残留条目纳入泄漏检查。

06.5.7.8-014 上下文如何在派生协程间传递?

一句话结论

派生协程不会自动继承父协程局部变量;上下文通过闭包 use 显式带入、Channel 消息携带,或上下文对象按字段复制;需要在子协程内独立修改的字段复制副本,共享不可变数据可传引用。

概念解释

协程栈相互独立,父协程局部变量对子协程不可见。创建子协程时闭包 use 列出需要的变量;对象传的是引用,子协程修改属性会影响父方。需要隔离就复制值或不可变对象;需要共享就按同步规则保护。上下文传播链:入口 → 业务协程 → 派生任务协程,每一跳显式传递。

原理流程

  1. 父协程准备上下文数据。
  2. Coroutine::run() 闭包 use 所需字段或上下文对象。
  3. 不可变字段共享引用;可变字段复制副本。
  4. 子协程结果通过 Channel/结果结构回传。

代码或图示

<?php
// 文档示例:上下文字段显式传入派生协程
use Swow\Coroutine;

$traceId = "trace-123";
Coroutine::run(static function () use ($traceId): void {
    // 子协程内使用 $traceId;父协程其他局部变量不可见
});

常见误区

  • 期望子协程读到父协程后续赋值的局部变量:use 绑定时机与引用关系需理清。
  • 共享可变上下文对象不加保护:子协程间交错写入产生竞争。

追问

  • 框架自动透传上下文吗?答:部分框架实现上下文复制;需核对其规则,不假设所有字段自动继承。
  • 大上下文复制成本高怎么办?答:传递不可变引用 + 标识字段,按需取数,不整份拷贝。

06.5.7.8-015 长生命周期协程与短请求协程的资源区别是什么?

一句话结论

短请求协程随请求结束回收局部状态;长生命周期协程(后台任务、监听循环、观测器)长期持有资源,必须管理自身循环退出条件、状态复位与资源复用,不能按请求协程假设结束即清理。

概念解释

后台协程常驻运行:循环等待任务、周期执行、监控观测。其局部变量不随单请求回收,缓存的状态跨任务保留,需要每轮任务结束复位。长协程泄漏会长期占用栈与引用;退出时要释放持有连接、关闭通道与句柄。请求协程关注隔离,长协程关注复用与生命周期管理。

原理流程

  1. 识别协程类型:请求处理 vs 后台常驻。
  2. 长协程设计任务循环、退出信号与每轮状态复位。
  3. 持有的连接/缓冲按轮次复用或归还。
  4. 进程关闭时按信号路径优雅退出长协程。

代码或图示

<?php
// 文档示例:后台协程循环骨架
use Swow\Channel;
use Swow\Coroutine;

$quit = new Channel(1);
Coroutine::run(static function () use ($quit): void {
    while (true) {
        $signal = $quit->pop(1000);
        if ($signal !== null) {
            break;
        }
        // 周期任务;每轮结束复位临时状态
    }
});

常见误区

  • 长协程内缓存上一轮请求数据:下一轮任务读到残留。
  • 后台协程无退出条件:进程关闭时被强杀,资源不回收。

追问

  • 长协程异常退出怎么办?答:入口兜底 catch + 重启策略(框架/进程 supervisor)。
  • 后台任务并发额度如何控制?答:信号量或有界 Channel 限制在途任务数。

06.5.7.8-016 协程泄漏的典型表现与定位方法是什么?

一句话结论

协程泄漏表现为协程数持续上涨、内存增长、等待挂起协程累积;定位通过 Coroutine::count() 与 getAll() 快照找长期 waiting/超龄协程,读栈帧与等待设施,回溯创建点与未回收资源。

概念解释

泄漏成因:任务协程未退出、通道/同步设施无人满足条件、协程被全局容器长期持有、异常后残留引用。定位四步:数量监控发现增长 → 快照分类 waiting/running → 栈帧定位等待条件 → 回溯协程创建与持有链。修复后压测验证协程数回落基线。

原理流程

  1. 监控协程总数与内存,设置增长告警。
  2. 快照 getAll,按状态与耗时筛选异常协程。
  3. 读栈帧判断等待设施:Channel、Sync、IO。
  4. 核对对端协程存活与资源引用,修复未退出/未关闭路径。

代码或图示

<?php
// 文档示例:超龄 waiting 协程筛查
use Swow\Coroutine;

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

常见误区

  • 只看内存不看协程数:协程栈与等待映射也是泄漏载体。
  • 发现泄漏直接 kill 全部:需先定位根因,避免掩盖未回收路径。

追问

  • 通道泄漏与协程泄漏关系?答:无人消费的通道挂起生产者协程,两者互相影响;见 06.5.7.4-015。
  • 泄漏定位工具?答:SDB 调试器与快照采集;见 06.5.7.13 批次。

06.5.7.8-017 串数据类故障的排查思路是什么?

一句话结论

串数据排查从“哪个共享状态被多协程写”入手:对比请求标识与数据归属,定位静态/单例/共享对象属性,检查上下文传递与连接复用,再用并发用例复现并修复存放位置。

概念解释

串数据典型现象:A 请求读到 B 的用户信息、订单数据错乱、缓存结果张冠李戴。排查路径:故障请求日志带 CID 与追踪 ID → 沿数据来源回溯写入点 → 检查静态变量、单例属性、共享缓存、复用连接会话状态。复现用多协程并发调用同一服务对象,观察属性污染。

原理流程

  1. 收集故障请求标识、CID、时间线与错误数据。
  2. 回溯数据写入路径,标记所有共享状态写入点。
  3. 检查单例属性、静态变量、缓存键是否混入请求态。
  4. 并发用例复现,修复为局部/上下文存储,补充回归测试。

代码或图示

<?php
// 排查检查点(文档示例)
// 1. static 变量/属性 是否存请求态
// 2. 单例对象属性 是否被多协程写入
// 3. 复用连接 是否残留会话状态
// 4. 缓存键 是否携带请求维度隔离

常见误区

  • 把串数据当随机偶发:通常有明确共享写入点,并发调度交错才触发。
  • 只改当前出错字段:同类共享状态需一并清理。

追问

  • 连接会话残留怎么查?答:归还前是否重置事务、select 库、订阅状态;并发复用对照响应归属。
  • 回归测试怎么写?答:多协程并发调用同一服务,断言各协程结果与自身请求标识一致。

06.5.7.8-018 第三方库与全局容器在协程化下的改造点有哪些?

一句话结论

改造点:识别库内全局/静态状态、连接管理与回调执行环境;把请求态移出全局存储,连接改为池化独占,确认回调运行在协程上下文;框架容器在常驻模型下区分进程级单例与请求级对象。

概念解释

FPM 时代编写的库假设请求结束即清理,常驻后假设失效。改造逐项核对:静态缓存、全局单例、内部连接、文件句柄、回调注册。依赖 Swoole API 的库需要替换为 Swow 对应实现或适配层。容器注入的对象标注生命周期,请求级对象不要注册为常驻单例。

原理流程

  1. 盘点第三方库:静态状态、连接、回调、全局容器使用。
  2. 核对协程安全声明与源码实现。
  3. 不兼容部分编写适配层:池化连接、上下文传递、异常转换。
  4. 并发压测验证无串数据、无阻塞卡死。

代码或图示

# 依赖盘点示例
composer show --tree
composer why ext-swoole

常见误区

  • 假设纯逻辑库也无状态:仍需检查其内部静态缓存与单例。
  • 框架容器把请求级对象注册为单例:请求数据跨请求污染。

追问

  • 生态兼容专题在哪一批?答:06.5.7.12 生态兼容与框架集成(规划中)。
  • 适配层放哪里?答:项目内部隔离封装,不直接改第三方库源码。

06.5.7.8-019 协程安全编码检查清单有哪些?

一句话结论

清单覆盖:请求态存放、共享状态同步、连接归属与归还、异常路径清理、上下文显式传递、长协程状态复位、并发用例覆盖;评审与自查按项逐项核对。

概念解释

清单用于代码评审与上线前自查。请求态不进全局/静态/单例;共享可变状态加锁或走 Channel;连接借出独占、异常归还;清理挂 defer/finally;上下文显式传递;后台协程每轮复位;并发用例验证隔离与回收。每一项对应可检查的代码位置,不写空泛原则。

原理流程

  1. 数据分类:进程级不可变 / 共享可变 / 请求态私有。
  2. 状态存放按分类落位,共享项配同步设施。
  3. 资源配对获取与释放,覆盖异常分支。
  4. 并发压测与回归用例验证隔离、回收与无串数据。

代码或图示

检查清单
[ ] 无请求态写入 global / static / 单例属性
[ ] 共享可变状态有锁或 Channel 保护
[ ] 连接池借还路径完整,异常归还
[ ] defer/finally 覆盖句柄、缓冲、锁释放
[ ] 上下文显式传参,派生协程显式复制
[ ] 长协程每轮复位临时状态
[ ] 并发用例验证结果隔离与资源回落

常见误区

  • 清单只在新功能执行:存量改造同样需要逐项扫描。
  • 评审只看业务逻辑,不看资源与状态存放:事故多发生在共享状态与回收路径。

追问

  • 清单如何纳入工程流程?答:作为 MR 评审 checklist,配合静态扫描与并发测试。
  • 哪些项最容易漏?答:异常路径归还、后台协程复位、派生协程上下文复制。

06.5.7.8-020 从 FPM 思维切换到常驻协程模型要改哪些习惯?

一句话结论

核心转变:从“请求结束自动清理”转为“显式管理生命周期”,从“全局可用”转为“按协程隔离状态”,从“同步串行”转为“IO 并发 + 资源归属明确”,并接受常驻内存带来的泄漏与串数据风险需要主动治理。

概念解释

FPM 习惯里请求结束一切销毁,全局状态天然隔离;常驻模型要求主动设计状态生命周期。编码习惯逐项调整:不依赖请求结束重置,单例只放进程级依赖,连接池化独占,异常路径显式清理,并发调用带超时与隔离。排查习惯也从单请求日志转向协程快照与并发压测。

原理流程

  1. 生命周期:区分进程级、请求级、协程级对象与数据。
  2. 状态管理:请求态入上下文,共享态加保护。
  3. 资源管理:连接/句柄配对获取释放,异常不遗漏。
  4. 并发验证:压测并发场景,检查隔离、回收与泄漏基线。

代码或图示

思维对照
FPM:请求结束自动销毁全局状态
常驻:状态生命周期显式设计,单例只存进程级依赖
FPM:同步串行调用
常驻:IO 并发,连接独占,超时与异常分支完备
FPM:单请求日志排查
常驻:协程快照 + 并发压测 + 资源基线对比

常见误区

  • 把 FPM 控制器代码直接搬进常驻服务:状态假设不同,必须梳理改造。
  • 上线后只看功能正确性:并发隔离与资源回收需要专项验证。

追问

  • 迁移改造顺序建议?答:先梳理状态与连接,再改造调用链并发化,最后补并发测试与监控。
  • 如何确认本机扩展支持上述 API?答:php --ri swow 加载后反射类方法;本批环境未安装,方法名与行为以官方 API 文档为准(待确认)。