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

06.5.6.14 内存泄漏与调试排障

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

06.5.6.14-001 常驻服务的内存泄漏与 FPM 模式内存问题有什么不同?

一句话结论

FPM 每请求结束即销毁进程,内存随请求释放;常驻服务进程长期存活,残留对象、静态缓存与未回收协程跨请求累积,泄漏表现为 RSS 随时间单调上涨,必须主动识别与回收。

概念解释

FPM 模式下请求结束进程退出,PHP 堆、局部变量与连接一并回收,单次请求内存占用高不构成长期泄漏。Swoole Worker 常驻内存,请求结束后只有无引用对象被回收;被长生命周期结构持有的对象持续存活。因此常驻服务的泄漏是“跨请求残留”,排查重点是对象引用链与生命周期,而不是单请求峰值。

原理流程

  1. 请求处理完成,协程/回调返回。
  2. 栈上局部变量引用计数递减,无引用对象由 PHP 回收。
  3. 被静态属性、全局数组、Table、Channel 持有的对象保留。
  4. 下一轮请求继续叠加,RSS 趋势只涨不落即泄漏特征。

代码或图示

FPM:请求结束 → 进程销毁 → 内存全部释放
常驻:请求结束 → 无引用对象回收 → 长生命周期引用保留
泄漏特征:多次同压测后 RSS 不回落,逐轮抬高

常见误区

  • 用 FPM 经验判断常驻内存:FPM 的“请求内存高”不等于常驻服务泄漏。
  • 看到内存上涨就判定泄漏:需先区分正常缓存预热与累积残留。

追问

  • 常驻服务为什么还需要 max_request?答:进程轮换作为兜底,释放少量残留累积;它不替代根因修复。
  • 泄漏最终会怎样?答:RSS 达到进程/系统上限后触发 OOM 或内存分配失败,进程异常退出。

06.5.6.14-002 常驻内存泄漏的主要成因有哪些分类?

一句话结论

成因分为五类:长生命周期容器只增不减、请求态对象进入静态/全局存储、闭包与对象引用链残留、协程/连接等资源未回收、外部扩展或底层结构持有引用;排查按引用链逐层展开。

概念解释

分类便于定位:第一类是缓存/日志数组持续追加不清理;第二类是把请求参数、结果、连接挂到单例属性;第三类是闭包捕获大对象、回调注册后未注销;第四类是协程永久挂起、连接未归还;第五类是第三方扩展或 Swoole 底层结构(Table、Channel、定时器)持有引用。实际泄漏常是多类叠加,需结合对象统计与代码路径核对。

原理流程

  1. 采集内存趋势,确认是单调上涨而非缓存预热。
  2. 列出进程内长生命周期容器:静态属性、全局数组、Table、Channel、定时器注册表。
  3. 检查请求态数据是否误入这些容器。
  4. 追踪闭包捕获与回调注册,核对资源(协程、连接)回收路径。

代码或图示

泄漏成因清单:
1. 容器只增不减:缓存 / 日志 / 列表持续追加
2. 请求态入静态:单例属性存放请求参数、结果、连接
3. 引用链残留:闭包捕获、回调未注销、对象互引
4. 资源未回收:挂起协程、未归还连接、定时器未清除
5. 底层结构持有:Table / Channel / 扩展对象残留引用

常见误区

  • 把所有上涨归给 PHP 代码:底层结构与扩展引用也可能持有对象。
  • 只查全局变量:单例静态属性、类静态数组同样是长生命周期容器。

追问

  • 如何给成因分类定边界?答:以对象最终被哪个长生命周期结构持有为准;同一对象可能被多层引用逐层保留。
  • 第三方扩展导致的泄漏怎么判断?答:代码侧引用清理后内存仍涨,结合扩展版本与官方 issue/文档核对,待确认。

06.5.6.14-003 协程未回收或永久挂起如何造成内存泄漏?

一句话结论

协程永久挂起后栈、上下文与其持有的堆对象、连接无法回收,在飞协程数只涨不落,表现为内存与连接占用同步累积。

概念解释

正常协程结束后栈与控制结构回收。永久挂起的协程(等待永不就绪的通道、事件或信号)持续占用栈与元数据;其闭包引用的数组、对象、连接也无法释放。泄漏特征:协程数趋势不回落,伴随连接池在借数或 Channel 等待数上涨。修复方向是补齐取消/完成信号,让挂起条件可达成。

原理流程

  1. 协程进入等待状态,等待事件登记到运行时。
  2. 事件因逻辑缺陷永不触发(通道无消费者、信号未发送)。
  3. 协程无法结束,栈与持有对象长期保留。
  4. 每轮请求叠加残留协程,内存与连接占用单调上涨。

代码或图示

use Swoole\Coroutine\Channel;

$ch = new Channel(1);
go(function () use ($ch) {
    $ch->push(1); // 若无人 pop,当前协程永久挂起
});
// 泄漏排查:在飞协程数 / 通道等待数 / 连接在借数是否同步上涨

常见误区

  • 以为协程栈会自动回收:只有协程结束才回收,永久挂起不释放。
  • 只看内存不看协程数:协程泄漏的配套指标是在飞协程与等待事件计数。

追问

  • 如何识别挂起协程在等什么?答:扩展协程统计/遍历接口以版本为准,待确认;业务埋点记录 CID、任务标识与等待步骤辅助定位。
  • 残留协程能在进程内强制清理吗?答:协作式模型下优先修复挂起条件;存量残留靠进程轮换释放,运行时通用强清手段待确认。

06.5.6.14-004 静态变量与全局数组只增不减有什么风险?

一句话结论

静态属性、全局数组作为进程级容器持续追加条目而不淘汰,条目跨请求累积,是常驻服务最常见的泄漏来源;必须设置淘汰策略、容量上限或按请求清理。

概念解释

静态变量与全局数组在进程存活期间一直存在。业务常把缓存、调用记录、错误日志、临时结果写入这些容器,忘记过期淘汰。数组条目含字符串、数组或对象引用时,单条占用随内容放大。长期运行后容器占用成为 RSS 主要部分。排查时搜索静态属性写入点与 $GLOBALS 追加操作,核对清理路径。

原理流程

  1. 定位静态属性、静态数组与 $GLOBALS 的写入位置。
  2. 统计条目增长是否随请求数线性上升。
  3. 区分合理缓存(有过期/容量策略)与无界追加(泄漏)。
  4. 为无界容器补充淘汰策略、容量上限或请求结束清理。

代码或图示

// 反例示意:静态数组持续追加,无淘汰
class RequestLog
{
    public static array $lines = [];
}
go(function () {
    RequestLog::$lines[] = 'request record'; // 常驻进程中只增不减
});

常见误区

  • 用静态数组做请求内临时缓存:请求结束应清理,静态容器跨请求存活。
  • 只清理数组顶层键值:嵌套数组与对象引用需逐级解除。

追问

  • 合理缓存怎么控制大小?答:容量上限 + 过期时间 + 淘汰策略(按时间/ LRU 一类);具体实现按业务选择。
  • 日志类累积怎么落盘?答:定期批量写入文件/日志服务后清空内存缓冲,不在内存保留全量历史。

06.5.6.14-005 单例属性存放请求态数据有什么风险?

一句话结论

单例在进程内全局共享,把请求参数、用户信息、结果集或连接存进单例属性,会导致跨请求/跨协程数据残留与串用,残留对象同时构成内存泄漏。

概念解释

单例对象生命周期等同进程,其属性不会随请求结束清空。请求态数据(当前用户、请求参数、查询结果、临时连接)挂上去后:下一个请求读到上一轮残留,出现串数据;对象引用长期被单例持有,无法回收。正确做法是请求态走协程局部变量或请求上下文,单例只保留只读配置与无状态服务逻辑。

原理流程

  1. 审查单例类属性,区分只读配置与请求态字段。
  2. 请求态字段从单例移除,改为局部/上下文传递。
  3. 连接类资源交由连接池借还,不固化在单例属性。
  4. 长稳压测观察单例占用与跨请求数据隔离。

代码或图示

// 风险示意:单例属性被写成请求态
class DemoService
{
    private static ?DemoService $instance = null;
    public array $currentRequest = []; // 请求态不应放在单例
    public static function instance(): self { /* ... */ return self::$instance; }
}

常见误区

  • 认为单例“只有一份所以安全”:共享正是串数据与残留的根源。
  • 在单例属性缓存数据库连接:连接归属池管理,固化后其他协程可能误用。

追问

  • 协程上下文能替代单例存请求态吗?答:上下文存取的隔离语义按框架实现核对;核心原则是请求态不进入进程级单例。
  • 历史代码已把请求态放单例怎么改?答:先列出属性使用点,按请求边界迁移;回归并发串数据与内存回落。

06.5.6.14-006 闭包捕获与长生命周期对象引用链如何造成残留?

一句话结论

闭包按捕获规则持有外部变量引用,回调注册到定时器/事件/队列后长期存活,连带捕获的大对象无法释放;对象间互相引用也会形成引用环残留。

概念解释

闭包 use 捕获的变量进入闭包存储,只要闭包存活,被捕获对象就有引用。定时器回调、异步任务回调、事件监听若不注销,闭包与其捕获链长期驻留。PHP 引用计数可回收简单引用环,但混入 Swoole 底层结构、扩展对象或长生命周期容器时,环可能不被正常释放。排查需沿闭包注册点追踪捕获对象与注销路径。

原理流程

  1. 定位闭包注册位置:定时器、任务队列、事件回调、完成通道。
  2. 列出闭包捕获的变量及其引用的对象链。
  3. 核对回调是否在任务结束后注销/移除。
  4. 对引用环检查是否被底层结构持有,必要时显式解除引用。

代码或图示

use Swoole\Timer;

// 示意:定时器闭包捕获大对象;回调不清除则对象长期存活
$big = str_repeat('x', 1024 * 1024);
Timer::tick(1000, function () use ($big) {
    // $big 被闭包持有,随定时器回调长期存活
    echo strlen($big) . "\n";
});

常见误区

  • 以为局部对象在函数返回后即释放:被闭包捕获并注册后,生命周期由闭包决定。
  • 忽略对象互引:两个对象互相持有引用,需结合底层容器判断是否可回收。

追问

  • 如何确认闭包是否注销?答:核对定时器 ID 清除、任务完成后的回调移除;结合现存定时器/任务统计对照。
  • 引用环一定泄漏吗?答:PHP 引用计数对普通环可回收;混入扩展对象、底层容器时回收行为需实测核对,待确认。

06.5.6.14-007 连接与其他资源未释放如何累积?

一句话结论

数据库/Redis/HTTP 连接、文件句柄、定时器等资源未归还或关闭,会随请求累积占用 fd 与内存;资源残留通常与对象泄漏叠加表现。

概念解释

连接对象被池借走后不归还,占用池名额与 fd;手动新建连接不关闭,fd 泄漏。定时器注册后不清除,回调与其捕获对象长期存活。资源残留的识别指标:fd 数量、连接池在借数、现存定时器数趋势。处置原则:借出有归还、创建有关闭、注册有清除,异常路径同样覆盖。

原理流程

  1. 采集 fd 总数、池在借/空闲数、定时器计数趋势。
  2. 对照请求量判断是否只涨不落。
  3. 检查异常分支:抛提前退出、超时取消后是否漏归还/关闭。
  4. 在 finally 类路径补全资源释放,压测回归资源回落。

代码或图示

// 示意:连接借还必须覆盖异常路径
go(function () use ($pool) {
    $conn = $pool->pop();
    try {
        // 使用连接执行业务
    } finally {
        $pool->push($conn); // 异常路径也归还
    }
});

常见误区

  • 只在成功路径归还连接:异常/超时路径泄漏资源。
  • 定时器靠进程重启清理:进程内未清除的定时器跨请求累积。

追问

  • fd 耗尽有什么表现?答:新连接/新客户端报错,日志含 fd 或资源上限提示;核对 ulimit -n 与服务连接配置。
  • 资源残留与对象泄漏怎么联动排查?答:资源对象被长生命周期持有时同时泄漏;先释放资源引用,再看对象内存是否回落。

06.5.6.14-008 如何观察进程内存趋势?

一句话结论

按固定间隔采集进程 RSS、PHP 内存占用与在飞协程/连接数,形成时间序列;区分预热上升、稳态波动与单调泄漏趋势,采样需覆盖多次完整请求周期。

概念解释

观测项:操作系统视角的 RSS(常驻内存)、PHP 层内存使用函数读数、协程数、连接数、定时器计数。单次读数无法判断趋势,必须时间序列对比。预热阶段内存自然上升,缓存建立后应回落稳定;泄漏表现为相同负载下逐轮抬高、不随请求结束回落。采样间隔与时长按业务周期设定。

原理流程

  1. 确定采集点:系统内存指标 + PHP 内存函数 + 业务资源计数。
  2. 预热后开始采样,覆盖多轮请求与长稳时段。
  3. 绘制 RSS 与资源计数曲线,判断趋势类型。
  4. 对单调上涨曲线进入引用链排查。

代码或图示

# Linux 示意:按 PID 查看进程内存占用(具体工具按环境选择)
# ps -o pid,rss,vsz,cmd -p <pid>
# 配合应用内埋点周期记录 PHP 内存与协程/连接计数

常见误区

  • 只看峰值内存:峰值正常不代表长稳趋势无泄漏。
  • 采样时间太短:预热与缓存建立阶段的上升被误判为泄漏。

追问

  • PHP 内存函数有哪些?答:memory_get_usage()、memory_get_usage(true) 一类;读数口径(真实分配 vs 栈上预留)以 PHP 文档为准。
  • RSS 与 PHP 内存读数不一致怎么办?答:RSS 含底层分配、扩展与库占用;两者差值用于判断泄漏是否在 PHP 业务层。

06.5.6.14-009 内存快照与增量对比怎么做?

一句话结论

在同一负载基线先后采集内存快照/对象统计,对比增量对象类型与数量,定位新增残留来自哪类对象;快照对比需控制环境一致、排除正常缓存增长。

概念解释

快照思路:压测一轮请求后记录对象类型/数量与内存占用,再压测一轮对比增量。增量集中在某类对象(数组、字符串、特定类实例)即指向对应代码路径。可用的 PHP 内存/对象统计接口与扩展能力以本机版本为准,不确定处标注待确认。对比前先确认缓存预热完成,避免把首次加载计入增量。

原理流程

  1. 预热服务,记录基线内存与对象统计。
  2. 执行固定批次请求,等待请求结束回收。
  3. 采集第二轮快照,对比对象类型、数量与内存增量。
  4. 增量异常的对象类型回溯到创建代码与持有容器。

代码或图示

// 示意:记录 PHP 内存读数作为快照对比基线
$base = memory_get_usage(true);
// ... 执行固定批次请求 ...
$after = memory_get_usage(true);
var_dump($after - $base); // 增量读数;对象级统计接口以版本为准

常见误区

  • 两次快照之间负载不一致:增量混入正常业务波动,结论失真。
  • 只对比总内存:总量下降看不出哪类对象残留,需按类型拆分。

追问

  • 对象级快照工具依赖什么?答:可能需要 PHP 调试扩展或扩展内置统计接口;本机未安装 Swoole 扩展,具体能力待确认,验证手段为 php -m 与官方文档。
  • 快照对比发现字符串增量怎么查?答:字符串常作为数组/对象元素被持有;回溯静态数组、日志缓冲与缓存条目。

06.5.6.14-010 如何区分泄漏与正常缓存增长?

一句话结论

正常缓存有容量上限与淘汰策略,达到稳态后内存不再随请求数增长;泄漏是无界累积,相同负载下 RSS 与条目数逐轮抬高。

概念解释

判断维度:是否有上限配置、条目是否按时间/容量淘汰、多轮压测后曲线是否走平。缓存预热期上升属正常;命中淘汰策略后应稳定。日志缓冲、会话记录、临时结果等“伪缓存”常被当成合理缓存而不设上限。区分时把容器策略与实际增长曲线对照,而不是凭用途判断。

原理流程

  1. 列出所有进程内容器及其淘汰策略。
  2. 多轮固定负载压测,观察条目数与内存曲线。
  3. 达到上限后走平:正常缓存;持续线性增长:泄漏。
  4. 无策略容器补充上限与淘汰,或改为外部存储。

代码或图示

判断对照:
正常缓存:有容量 / 过期策略 → 稳态后曲线走平
泄漏累积:无界追加 → 条目数与 RSS 随请求数线性上涨
伪缓存:日志 / 记录 / 临时结果,常被误认为合理缓存

常见误区

  • 用途是“缓存”就默认合理:伪缓存同样需要上限策略。
  • 只看内存总量不看条目数:缓存条目增长但单条很小,内存曲线可能滞后。

追问

  • 缓存达到上限后还上涨说明什么?答:淘汰策略未生效或容量配置未覆盖该容器;核对代码路径与配置项。
  • 外部缓存是否计入进程内存?答:不在本机进程内存;本机只保留必要本地缓存,大容量数据放外部存储。

06.5.6.14-011 CPU 飙高如何排查?

一句话结论

先确认 CPU 是单进程/单核心打满还是整机饱和,再按热点代码定位:长循环、密集序列化/正则、频繁数组操作、阻塞重试或死循环;结合耗时分解与进程状态下钻。

概念解释

CPU 飙高成因:纯计算热点代码、正则回溯、大数组/字符串反复复制、循环内重复初始化、异常重试风暴、协程调度堆积。排查顺序:定位高 CPU 进程与 Worker,采样其执行热点,对照请求耗时分解;区分 CPU 密集正常负载与失控循环。系统级采样工具按环境可用性选择,应用内埋点记录各环节耗时。

原理流程

  1. 识别高 CPU 进程:整机 CPU 、单 Worker 占用与进程状态。
  2. 采集热点位置:系统采样工具或应用耗时埋点。
  3. 归类热点:循环/正则/序列化/数组操作/重试风暴。
  4. 优化代码路径,压测回归 CPU 利用率与延迟。

代码或图示

CPU 排查路径:
高 CPU 进程定位 → 热点函数 / 代码段
  → 归类:长循环 / 正则回溯 / 序列化 / 数组复制 / 重试风暴
    → 优化或拆分到异步进程 → 压测回归

常见误区

  • CPU 高就加 Worker:热点代码未除,加进程只是分摊。
  • 忽略阻塞重试风暴:下游超时后密集重试会把 CPU 与下游同时打满。

追问

  • 如何区分正常计算与失控循环?答:对照业务请求量与 CPU 曲线;单请求 CPU 占用异常高即热点,结合代码采样定位。
  • 采样工具本机可用吗?答:取决于环境安装的调试工具;本机未装 Swoole 扩展,具体工具能力待确认,应用埋点是兜底手段。

06.5.6.14-012 慢循环、正则与序列化的 CPU 热点如何定位?

一句话结论

按耗时分解定位热点段:循环内逐次耗时累积、正则回溯导致单次执行暴增、序列化随返回体大小线性放大;用分段计时与样本对比确认热点类型。

概念解释

三类常见热点特征:慢循环在累计耗时上随迭代次数放大;正则灾难性回溯在特定输入下单次匹配极慢;序列化/编解码耗时随数据规模增长。定位方法是在循环体、正则调用、序列化节点分别埋点计时,压测对比不同数据量下的耗时曲线。优化方向对应:循环批处理与让出、简化正则与预编译、精简输出结构。

原理流程

  1. 在疑似热点节点埋点:循环体、正则、序列化、数组映射。
  2. 压测不同数据量样本,记录各节点耗时分布。
  3. 按增长曲线判断热点类型:迭代累积 / 单次回溯 / 规模线性。
  4. 实施对应优化,回归 CPU 与延迟。

代码或图示

go(function () {
    $start = microtime(true);
    // 热点段:序列化 / 正则 / 循环处理
    $payload = json_encode(array_fill(0, 1000, ['k' => 'v']));
    $cost = (microtime(true) - $start) * 1000;
    echo sprintf("encode cost: %.2f ms\n", $cost);
});

常见误区

  • 只给整段业务计时:无法区分循环、正则、序列化各占多少。
  • 正则在短样本上正常就放过:回溯问题只在特定输入下暴露。

追问

  • 正则回溯怎么缓解?答:避免嵌套量词、拆分匹配、限制输入长度;必要时换解析方案。
  • 序列化热点怎么优化?答:精简字段、分批输出、减少对象到数组的重复转换;格式选型按业务要求评估。

06.5.6.14-013 进程崩溃与 core dump 如何获取?

一句话结论

进程段错误/致命退出可能产生 core dump,需确认系统 core 开关、转储路径与崩溃信号;PHP 层致命错误与底层段错误的记录路径不同,崩溃现场要尽快保留。

概念解释

崩溃分两层:PHP 致命错误(Fatal Error)通常有错误日志记录;底层段错误(SIGSEGV 一类)可能直接终止进程,需 core dump 分析堆栈。获取前提:系统 core 转储未被关闭、进程资源限制允许、转储目录可写。崩溃后 core 文件覆盖风险要评估;本机未安装 Swoole 扩展,崩溃复现与分析手段需在目标环境核对。

原理流程

  1. 确认崩溃类型:PHP 错误日志记录还是信号终止。
  2. 检查系统 core 开关与转储路径、进程 ulimit -c 限制。
  3. 崩溃发生后保留 core 文件与对应二进制/符号信息。
  4. 用调试工具读取堆栈,定位崩溃调用位置。

代码或图示

# Linux 示意:查看 core 开关与进程 core 限制(具体按环境)
# ulimit -c
# cat /proc/sys/kernel/core_pattern
# 崩溃 core 文件路径以上述配置为准

常见误区

  • 崩溃后直接重启清理现场:core 文件与日志被覆盖,无法回溯。
  • 把 PHP Fatal 当成底层崩溃:两者记录与分析路径不同。

追问

  • core dump 包含哪些信息?答:崩溃时内存映像、寄存器与调用堆栈;分析需匹配对应版本二进制与符号信息。
  • 没有 core 文件怎么排查?答:先看 PHP/Swoole 错误日志、系统日志与退出信号;在测试环境最小复现后再采集转储。

06.5.6.14-014 堆栈分析如何定位崩溃位置?

一句话结论

堆栈分析沿崩溃帧向上回溯调用链,结合版本符号信息定位到具体代码路径;先确认崩溃信号与崩溃帧所属扩展/PHP 层,再核对对应版本代码与已知问题。

概念解释

堆栈顶部为崩溃发生帧,向下为调用链。分析要点:崩溃帧在 PHP 业务代码、Swoole 扩展还是第三方扩展;是否有符号信息可读函数名;对照安装版本的官方文档与已知问题。信息不足时在测试环境最小复现,配合错误日志与调用链埋点缩小范围。不能凭堆栈片段猜测不确定的底层行为,标注待确认。

原理流程

  1. 读取 core 堆栈,确认崩溃信号与顶部帧。
  2. 沿调用链回溯,区分 PHP 层与扩展层帧。
  3. 核对 Swoole/PHP 版本与该版本已知问题、变更说明。
  4. 在测试环境最小复现,补充日志后再定位具体代码。

代码或图示

堆栈阅读顺序:
顶部崩溃帧 → 向下调用链
标注每帧归属:PHP 业务 / Swoole 扩展 / 第三方扩展
对照:版本号 / 官方变更文档 / 测试环境复现

常见误区

  • 堆栈顶部帧就是业务根因:崩溃可能由上游传入非法状态引发,需回溯调用链。
  • 无符号信息时猜测函数名:无法确认的底层细节标注待确认。

追问

  • 堆栈显示扩展内部崩溃怎么办?答:先核对版本与已知问题,检查传入参数是否合法;必要时向官方 issue 提供复现脚本与版本信息。
  • 如何保留匹配的符号信息?答:调试分析环境使用与崩溃环境一致的二进制/扩展版本,避免版本错配导致堆栈误读。

06.5.6.14-015 协程栈溢出与内存错误如何识别?

一句话结论

栈溢出表现为深层递归/大局部变量下的错误或崩溃;内存错误包括分配失败、类型错误与底层越界,识别需结合错误日志、复现路径与版本核对,不臆断具体报错文案。

概念解释

协程栈过小在深调用链上触发栈溢出;内存分配失败发生在堆耗尽时。错误文案、退出方式随版本与错误类型不同,需在目标环境核对。识别步骤:记录崩溃/错误发生时的请求路径、调用深度、局部变量规模与内存读数;区分栈空间不足、堆耗尽与非法访问。修复方向:调整栈大小、简化调用链、释放大对象与定位泄漏。

原理流程

  1. 收集错误日志:错误类型、退出信号、发生时请求路径。
  2. 估算调用深度与局部变量规模,对照栈大小配置。
  3. 采集当时内存/堆占用,判断是否堆耗尽。
  4. 测试环境复现后核对版本行为,标注不确定项。

代码或图示

use Swoole\Coroutine;

// 栈大小配置入口以官方文档为准;深递归场景先压测最深调用链
Coroutine::set(['stack_size' => 2 * 1024 * 1024]);

常见误区

  • 出现崩溃就调大栈:根因可能是堆泄漏或非法访问,调大栈不解决问题。
  • 凭记忆写报错文案:版本间错误信息不同,以本机实际输出为准。

追问

  • 栈溢出与堆耗尽如何区分?答:栈溢出关联深调用链与局部变量规模;堆耗尽表现为整体内存读数高、分配失败。
  • 不确定的错误行为怎么处理?答:标注待确认,记录验证手段(php --ri swoole、测试环境最小复现、官方文档对照)。

06.5.6.14-016 死锁/挂起与内存泄漏如何区分?

一句话结论

死锁/挂起表现为请求卡住、协程等待不结束,CPU 可能空闲;内存泄漏表现为 RSS 单调上涨;两者可叠加——挂起协程同时持有对象造成泄漏,排查时先分等待类型再看内存趋势。

概念解释

挂起问题的指标:在飞协程/请求不回落、通道等待堆积、接口超时;CPU 未必饱和。内存问题指标:RSS 与对象数量趋势上涨。叠加场景:永久挂起协程持有大对象,等待不解除且内存持续累积。区分顺序:先看请求是否结束、等待事件类型,再看内存曲线;不要把所有卡顿都归为内存问题。

原理流程

  1. 确认现象:请求超时卡住还是内存持续上涨。
  2. 挂起排查:等待通道/锁/IO/定时器类型,检查信号是否释放。
  3. 泄漏排查:RSS 与对象类型增量,定位持有容器。
  4. 叠加场景先解除挂起条件,再复核内存是否回落。

代码或图示

区分对照:
挂起 / 死锁:请求不结束、协程等待堆积、CPU 可能空闲
内存泄漏:RSS 单调上涨、对象条目累积
叠加:挂起协程持有对象 → 等待不解除 + 内存累积
排查顺序:等待事件类型 → 引用链与内存增量

常见误区

  • 接口慢就查内存:多数卡顿源于等待下游、锁或阻塞调用。
  • 内存涨了就忽略挂起:残留协程等待条件未解除,内存不会自行回落。

追问

  • 锁等待与通道等待怎么区分?答:按同步原语类型对照;Lock 相关见同步原语章节,Channel 阻塞语义见 Channel 章节。
  • 如何判断挂起是否永久?答:等待事件在业务上是否可能触发;超时未结束且无后续通知即为永久挂起。

06.5.6.14-017 日志与错误报告在排障中起什么作用?

一句话结论

结构化日志记录请求链路、各环节时间戳与资源标识,错误报告保留异常类型、消息与调用上下文;它们是崩溃、慢请求与泄漏排查的第一手数据,缺日志会导致只能盲猜。

概念解释

排障日志要素:链路 ID、Worker/CID、请求标识、进入与各节点时间戳、下游标识、错误类型与消息。常驻服务日志需控制内存缓冲、定期落盘。错误应在协程/任务边界捕获记录,避免静默丢失。线上先靠日志还原时间线,再结合资源指标定位;日志不足时在测试环境复现并补充埋点。

原理流程

  1. 设计日志字段:链路标识、进程/协程标识、环节时间戳、下游与错误信息。
  2. 异常边界统一捕获并记录,不依赖运行时默认行为。
  3. 线上问题先按链路 ID 串联日志,还原执行时间线。
  4. 日志定位方向后,再用内存/CPU/资源指标下钻。

代码或图示

go(function () {
    $cid = \Swoole\Coroutine::getCid();
    // 结构化记录:链路标识 / CID / 环节 / 耗时 / 结果
    echo sprintf("cid=%s step=start\n", var_export($cid, true));
    // ... 业务处理 ...
});

常见误区

  • 日志只写模糊消息:无链路标识与时间戳,无法串联多进程记录。
  • 错误只输出到默认错误流:线上需集中采集并关联请求上下文。

追问

  • 日志缓冲怎么避免内存累积?答:批量落盘或发送到日志服务后清空内存缓冲,容量设上限。
  • 崩溃前日志来不及刷出怎么办?答:关键节点及时落盘;配合错误回调记录,具体回调接口以版本为准,待确认。

06.5.6.14-018 常用调试手段有哪些,扩展限制如何核对?

一句话结论

调试手段分应用内埋点、系统工具与调试扩展三层;本机当前未安装 Swoole 扩展,所有扩展内置统计/调试接口都需在目标环境用 php -m、php --ri swoole 与官方文档核对,不确定处标注待确认。

概念解释

应用内:分段计时、内存读数、协程/连接计数埋点。系统层:进程内存/CPU 查看、core dump、堆栈分析。扩展层:协程统计、对象快照、调试接口等,可用性随版本不同。排障时先不依赖扩展内置能力,用应用埋点兜底;确认目标环境安装的扩展版本后,再启用对应统计接口。禁止在未核对版本前假设某接口存在或某默认值成立。

原理流程

  1. 确认目标环境 PHP/Swoole 版本与已加载扩展(php -m、php --ri swoole)。
  2. 先用应用内埋点复现并记录现象与时间线。
  3. 核对官方文档确认可用的统计/调试接口。
  4. 需要底层快照/堆栈时准备 core 分析环境,最小复现采集。

代码或图示

# 目标环境核对扩展与版本(本机未安装时先记录结论)
php -m | findstr /i swoole
php --ri swoole
# 调试扩展是否安装:php -m 列表核对

常见误区

  • 按其他版本经验调用统计接口:接口名与返回结构可能已变更。
  • 测试环境与线上扩展版本不一致:调试结论无法直接套用。

追问

  • 没有调试扩展怎么排查?答:分段埋点 + 系统进程指标 + 错误日志;最小复现后再考虑采集 core/快照。
  • 哪些结论必须标注待确认?答:扩展接口名、默认值、回调签名、栈大小默认值、错误文案;验证手段为版本核对与测试复现。

06.5.6.14-019 内存与稳定性问题排查清单是什么?

一句话结论

排查按“确认趋势 → 分层定位 → 引用链追溯 → 修复回归”推进:先区分预热/缓存/泄漏,再定位进程、协程、容器与对象类型,修复后长稳验证内存回落。

概念解释

清单覆盖观察、定位、修复、回归四段:采集 RSS、协程数、连接数趋势;分类成因(容器残留、请求态入静态、引用链、资源未回收、底层持有);回溯创建点与持有容器;补充回收与淘汰策略;长稳压测确认曲线走平。稳定性问题(崩溃、挂起、CPU 飙高)按各自指标路径并行排查。

原理流程

  1. 采集时间序列指标,确认问题类型与趋势。
  2. 对照成因清单定位可疑容器与对象类型。
  3. 沿代码路径追溯对象创建、捕获与持有关系。
  4. 修复资源释放/淘汰策略,压测与长稳验证回落,留存基线。

代码或图示

排查清单:
[观察] RSS / 协程数 / 连接数 / 定时器计数趋势
[分类] 容器追加 / 请求态入静态 / 闭包引用链 / 资源未回收
[追溯] 创建代码点 → 持有容器 → 解除路径
[修复] 归还 / 关闭 / 清除 / 淘汰策略
[回归] 长稳压测,曲线走平;记录基线与版本

常见误区

  • 发现一个残留点就结束:多成因叠加时需逐项核对清单。
  • 修复后只做短压测:泄漏需要长稳曲线确认回落。

追问

  • 修复后内存仍小幅上涨怎么办?答:区分缓存稳态增长与无界累积;有上限策略的缓存走平即可,持续线性上涨需继续排查。
  • 如何沉淀排查经验?答:记录问题现象、指标、根因与修复点,更新到章节待整理清单,供后续同类问题对照。

06.5.6.14-020 常驻服务稳定性维护有哪些常规手段?

一句话结论

常规手段包括:max_request 进程轮换兜底、内存/协程/连接指标监控告警、定期长稳压测、版本与配置变更回归、关键资源释放路径审计;手段是兜底防线,不能替代根因排查与代码治理。

概念解释

进程轮换释放少量残留累积;监控在泄漏早期告警;长稳压测在上线前暴露趋势问题;变更回归防止引入新残留;代码审计确保借还、关闭、清除路径完整。各手段互补:轮换不解决泄漏根因,监控不替代修复,压测不替代线上观测。日常维护按节奏执行并留存记录。

原理流程

  1. 配置 max_request 与 Worker 退出策略作为兜底轮换。
  2. 接入内存、协程数、连接数、fd 等指标与阈值告警。
  3. 版本发布前完成长稳压测与基线对比。
  4. 定期审计资源释放路径,跟进线上问题闭环。

代码或图示

稳定性防线:
进程轮换(max_request):释放残留兜底
指标监控:早期发现上涨趋势
长稳压测:上线前暴露累积问题
变更回归:防止新引入泄漏
路径审计:借还 / 关闭 / 清除完整

常见误区

  • 依赖重启/轮换解决一切:泄漏根因仍在,轮换间隔会越来越短。
  • 上线后不观测:压测环境未复现的残留只在生产长流量下暴露。

追问

  • max_request 阈值怎么定?答:结合内存增长曲线与重建成本;过小增加开销,过大累积风险,按压测与线上观测回调。
  • 哪些监控阈值需要先压测基线?答:内存增长速率、协程/连接在借上限、fd 占用;阈值基于稳定基线设定,不套用固定数值。