06.5.7.13 调试观测与性能分析
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.7 Swow
06.5.7.13-001 如何定位协程泄漏?
一句话结论
协程泄漏表现为活跃协程数随时间单调增长、任务长期挂起无回收;定位路径是遍历存活协程清单、查看状态与挂起点、对照任务来源与资源归属,区分“正常等待”与“未回收残留”。
概念解释
泄漏成因包括:连接未关闭、等待计数未释放、错误容器无消费方、长生命周期任务未设退出条件、异常路径跳过清理。观测先看趋势:压测或线上协程数是否在请求回落时同步下降;不回落即存在残留。协程遍历与状态查询 API 以当前版本文档为准(待确认,既有 06.5.7.3-013 已涉及按 ID 获取与遍历)。
原理流程
- 采集活跃协程数时间序列,确认是否单调增长。
- 遍历存活协程,记录 ID、状态、挂起位置与所属任务。
- 对照资源归属:连接、Buffer、Channel、计数是否与协程绑定。
- 定位未回收路径:异常分支、漏 done、无消费者通道、无退出条件循环。
- 修复后压测验证协程数随负载回落。
代码或图示
泄漏排查顺序
协程数趋势 → 遍历存活协程 → 状态与挂起点
→ 关联连接/缓冲/通道/计数 → 定位未回收分支
→ 修复 → 压测验证回落
常见误区
- 把正常等待下游的协程当泄漏:需结合超时与任务完成状态判断。
- 只看瞬时协程数:泄漏要看回落趋势,单时刻快照说明不了问题。
追问
- 协程安全与资源归属规则见哪里?答:06.5.7.8。
- 漏 done 导致挂起的典型场景?答:06.5.7.5-010。
06.5.7.13-002 如何定位协程死锁?
一句话结论
死锁表现为全部业务协程挂起、无就绪协程可调度,事件循环空转;定位手段是查看存活协程的等待对象与等待关系,配合调度器死锁处理器登记现场,机制细节见 06.5.7.7-016。
概念解释
常见死锁成因:循环等待 Channel/Sync、计数永不归零、持锁等待与释放路径冲突、主线程等待子协程而子协程依赖主线程结果。死锁处理器在调度器判定无就绪协程时触发,可用于转储协程清单与等待状态;处理器注册方法与转储能力以文档为准(待确认)。
原理流程
- 观察现象:请求全部超时,进程 CPU 不高但无协程推进。
- 导出存活协程清单与各自等待的对象(Channel、锁、连接)。
- 绘制等待关系,找出循环依赖或永不满足的条件。
- 核对计数配对、通道关闭、锁释放路径。
- 修复后并发复现验证调度恢复。
代码或图示
死锁识别
现象:无就绪协程,事件循环空转
现场:协程清单 + 等待对象 + 等待关系
成因:循环等待 / 计数不归零 / 锁未释放 / 父子协程互等
常见误区
- 把慢下游导致的批量等待当死锁:下游恢复后协程可继续推进。
- 死锁现场不保存:进程重启后等待关系无法回溯。
追问
- 死锁处理器如何注册?答:见 06.5.7.7-016;具体 API 名称与参数待确认。
- Channel 死锁典型成因?答:06.5.7.4-016。
06.5.7.13-003 如何查看协程堆栈与状态?
一句话结论
通过协程对象读取 ID、状态名、是否存活/可执行等信息,堆栈回溯能力取决于运行时与调试扩展支持;可查看的字段与方法签名以 API 文档为准(待确认),本机未安装扩展无法反射核对。
概念解释
协程状态区分运行中、就绪挂起、IO 等待、已结束等;堆栈信息用于判断协程停在哪个调用点。生产环境通常依赖框架导出的协程快照与日志上下文,完整调试栈回溯可能需要调试扩展配合,且受其兼容限制(见 06.5.7.13-008)。
原理流程
- 从协程对象或按 ID 获取协程实例。
- 读取状态字段,分类运行中与挂起等待。
- 采集调用位置、协程 ID 与上下文标识。
- 快照落日志或监控面板,供排障关联。
代码或图示
<?php
// 文档示例:协程信息读取形态(未实测,方法名待确认)
// $co = Coroutine::getById($id);
// var_dump($co->getId(), $co->getStateName(), $co->isAlive());
常见误区
- 假设生产环境能拿到完整调试堆栈:回溯能力受扩展与运行时限制。
- 只记录协程 ID 不记录状态与挂起点:排障时无法判断卡点。
追问
- 协程状态有哪些取值?答:以 API 文档状态常量表为准;既有 06.5.7.3-007 已说明状态查询入口。
- 如何把协程 ID 关联到请求?答:写入日志上下文与追踪标识,传递规则见 06.5.7.8-013。
06.5.7.13-004 CPU 占用如何观测与定位?
一句话结论
CPU 观测分进程级与协程级:先看进程 CPU 趋势与系统负载,再区分是 CPU 密集计算、阻塞死循环还是频繁调度切换;协程不减少 CPU 占用,计算密集瓶颈需要进程/线程级并行解决。
概念解释
常驻服务 CPU 高的常见原因:死循环未让出、序列化/加密等重计算、频繁对象创建与销毁、日志与加锁竞争。协作式调度下 CPU 密集死循环不会被强制打断,会饿死其他协程。观测手段包括系统级 CPU 统计、框架内耗时埋点与慢协程记录;具体采集工具按部署体系选择。
原理流程
- 采集进程 CPU 使用率与系统负载时间序列。
- 区分用户态/内核态占比,判断是计算还是系统调用开销。
- 对照接口耗时与慢协程清单,定位高占用任务。
- 检查是否存在无让出条件的循环与重计算逻辑。
- 优化后复测 CPU 趋势与延迟分布。
代码或图示
CPU 排查路径
进程 CPU / 负载趋势 → 用户态内核态拆分
→ 慢协程 / 热点接口 → 死循环 / 重计算 / 调度开销定位
常见误区
- 以为上协程就能降 CPU:协程改善 IO 等待利用率,不降低计算量。
- 只看平均 CPU:突发尖刺需要看短周期曲线与慢请求关联。
追问
- 协作式调度对 CPU 密集任务的影响?答:见 06.5.7.7-006;死循环占用期间其他协程饿死。
- 重计算如何扩容?答:进程/线程级并行或外部计算服务,协程内不解决 CPU 瓶颈。
06.5.7.13-005 内存占用如何观测与拆解?
一句话结论
内存观测看进程 RSS 与常驻对象、协程栈、Buffer、连接缓冲、缓存分配的趋势;常驻服务内存单调增长优先排查缓存未失效、对象复用未清零与缓冲累积,观测口径需区分堆内存与进程占用。
概念解释
PHP 内存包含 Zend 堆对象、协程栈空间、扩展分配缓冲与外部资源。常驻模型下对象不随请求销毁,内存基数高于 FPM;健康服务应在负载稳定后进入平台期,而非持续增长。内存峰值与回落需在压测全程记录,既有 06.5.7.6-015 已涉及 Buffer 内存控制。
原理流程
- 采集进程内存(RSS 等)时间序列与峰值。
- 区分增长来源:缓存、模型/对象、连接缓冲、Buffer、协程栈。
- 检查复用对象是否复位、缓存是否有失效策略。
- 压测结束后观察内存是否回落,不回落即存在残留。
- 必要时在隔离环境用内存分析工具定位热点分配。
代码或图示
内存拆解
进程 RSS
├─ Zend 堆:业务对象、数组、模型
├─ 协程栈:每协程上下文占用
├─ 缓冲:Socket/Buffer 待发待读数据
└─ 缓存:进程级字典与结果缓存
常见误区
- 内存比 FPM 高就判定泄漏:常驻模型基线更高,关键看是否平台期稳定。
- 只看峰值不看回落:压测结束后残留才是泄漏证据。
追问
- 协程栈大小如何配置/核对?答:待确认;查 API 文档与
php --ri swow配置项,既有 06.5.7.1-012 已提示。 - Buffer 累积怎么控制?答:06.5.7.6-015/020。
06.5.7.13-006 服务端压测应该怎么组织?
一句话结论
压测按梯度并发施加请求,覆盖正常负载、峰值与长稳阶段;记录吞吐、延迟、错误率与资源趋势,使用固定环境与预热样本,避免单次短测下结论。
概念解释
压测目标包括:验证协程并发承载、暴露阻塞点与泄漏、对比优化前后基线。工具选择按协议确定(HTTP 压测工具、RPC 客户端脚本等);下游使用测试环境或可控 mock,避免真实生产下游干扰结果。压测前完成预热,丢弃启动阶段样本;长稳阶段观察内存与协程数回落。
原理流程
- 确定压测场景:核心接口、典型报文大小与混合业务比例。
- 准备环境:同版本运行时、测试下游、监控采集就绪。
- 梯度加压:并发数从低到高,每档观察延迟与错误率。
- 长稳阶段持续施压,记录资源趋势与泄漏迹象。
- 留存压测脚本、环境版本与结果数据。
代码或图示
压测阶段
预热 → 梯度并发(吞吐/延迟/错误率)
→ 峰值按压 → 长稳观察(内存/协程/fd 趋势)
→ 结果归档与对比
常见误区
- 短时间高并发一次出结论:长稳泄漏与长尾延迟未覆盖。
- 压测环境连接真实生产下游:结果受外部波动影响。
追问
- 压测工具属于 Swow 能力吗?答:不属于;工具按协议在项目压测体系中选择。
- 压测环境版本要求?答:与生产基线一致,见 06.5.7.12-016。
06.5.7.13-007 性能指标口径如何定义?
一句话结论
核心指标为吞吐(请求/秒)、延迟(均值与分位数)、错误率、并发连接数与活跃协程数、资源占用;分位数比均值更能反映长尾体验,口径需在项目内统一记录。
概念解释
吞吐反映单位时间处理量;延迟看 P50/P95/P99 分布,均值会掩盖长尾;错误率区分超时、协议错误与下游错误;连接数与协程数反映并发承载;CPU/内存趋势反映资源健康。对比两次结果时必须使用相同场景与口径。
原理流程
- 定义指标采集点:入口记录请求开始与结束。
- 计算吞吐、延迟分位、错误分类占比。
- 关联采集协程数、连接数、CPU、内存。
- 按场景保存基线数据,供优化前后对比。
代码或图示
指标清单
吞吐:RPS / 请求成功率
延迟:P50 / P95 / P99,区分排队与处理耗时
错误率:超时 / 协议错误 / 下游错误分类计数
并发:活跃连接数、活跃协程数
资源:CPU、内存、fd 数趋势
常见误区
- 只用平均延迟评估体验:慢请求长尾被均值掩盖。
- 错误率不分类:无法区分服务自身问题与下游故障。
追问
- 分位数在哪里计算?答:框架埋点或监控系统聚合;采样比例需记录。
- 指标采集会影响性能吗?答:埋点开销需评估,关键路径避免重计算。
06.5.7.13-008 Xdebug 等调试扩展与协程运行时的兼容限制是什么?
一句话结论
调试扩展的断点、单步与栈回溯基于引擎执行流实现,在协程切换场景下可能出现回溯错乱、断点跨协程命中或性能下降;具体兼容程度需在目标版本实测(待确认),生产环境不应加载调试扩展。
概念解释
Xdebug 类扩展hook 引擎函数调用与返回,协程栈切换改变了执行上下文,调试器对“当前栈”的认知可能与实际协程不符。限制表现为:堆栈显示不完整、单步跳到其他协程、性能显著降低。开发调试优先使用日志快照与协程状态导出;需要断点时在隔离环境验证扩展兼容性。
原理流程
- 在隔离环境安装调试扩展并加载 swow。
- 跑基础协程用例,观察断点、单步与回溯是否正常。
- 记录兼容问题:栈错乱、跨协程跳转、性能损耗。
- 生产配置确认不加载调试扩展,避免性能与稳定性风险。
代码或图示
# 核对调试扩展是否加载(示例)
php -m
php --ri xdebug
php --ri swow
常见误区
- 在生产开启 Xdebug 排查问题:性能损耗与稳定性风险不可接受。
- 假设调试器能完整回溯所有协程:回溯能力受扩展支持边界限制。
追问
- 不依赖调试器如何定位?答:协程快照、状态导出、日志上下文与复现脚本,见本页其他条目。
- 兼容结论如何留痕?答:记录扩展版本、PHP 版本、现象与核对日期,标注待确认项。
06.5.7.13-009 日志与链路追踪在协程服务中如何接入?
一句话结论
日志与追踪以请求协程为上下文单位:进入协程生成或继承 traceId,贯穿下游调用与异常记录;上下文经参数/上下文对象传递,不挂全局静态变量,规则见 06.5.7.8。
概念解释
链路追踪需要跨协程、跨下游传递标识;日志记录协程 ID、traceId、连接标识与错误码。框架通常提供上下文绑定与追踪客户端适配;自研封装需在连接协程开始时初始化上下文,结束时清理。日志器本身须协程安全,避免写入成为阻塞点。
原理流程
- 请求进入协程,生成/继承 traceId 并绑定上下文。
- 下游调用与日志记录携带同一标识。
- 异常分支记录完整上下文与堆栈。
- 请求结束清理上下文,避免残留到下一请求。
代码或图示
追踪上下文
traceId / 协程 ID / 连接标识 / 请求摘要
→ 日志、下游调用、异常记录共用
→ 请求结束随协程回收
常见误区
- 把 traceId 存静态变量:跨协程串号。
- 异步子协程不继承上下文:链路断裂,需显式传入。
追问
- 追踪客户端协程安全如何判断?答:见 06.5.7.8-009 与 06.5.7.12-005。
- 日志敏感信息处理?答:06.5.7.10-018。
06.5.7.13-010 线上排障的标准步骤是什么?
一句话结论
排障按“现象确认 → 现场留存 → 协程与资源快照 → 日志关联 → 复现定位 → 修复验证”推进;先保住现场信息再处理重启,避免进程重启后证据丢失。
概念解释
典型步骤:确认故障范围(单接口/全服务/单实例)、采集监控曲线与错误日志、导出协程清单与连接/资源状态、关联 traceId 找到卡点、在隔离环境复现、修复后压测与灰度验证。涉及多实例时先定位是普遍问题还是单实例问题。
原理流程
- 确认现象:影响范围、错误类型、发生时间与持续时长。
- 留存现场:监控曲线、日志、协程快照、版本与配置信息。
- 关联分析:按 traceId/协程 ID 串联请求、下游与异常记录。
- 复现定位:隔离环境构造相同输入与并发条件。
- 修复验证:压测回归后灰度上线,观察指标回落。
代码或图示
线上排障流程
现象与范围 → 现场留存 → 协程/资源快照 → 日志关联
→ 隔离复现 → 定位根因 → 修复验证 → 灰度观察
常见误区
- 先重启再说:协程快照与内存现场丢失,根因无法追溯。
- 凭印象改代码:未复现定位的修复容易引入新问题。
追问
- 现场信息应留存哪些?答:见 06.5.7.13-018。
- 多实例故障如何拆分?答:对比实例指标与日志,判断是共性版本问题还是单实例资源/网络问题。
06.5.7.13-011 卡顿与超时如何定位到具体协程?
一句话结论
卡顿定位从慢请求/超时记录出发,关联协程 ID 与挂起位置,区分等待下游、等待锁/通道、未 hook 阻塞点与 CPU 占用四类成因;慢协程清单是主要入口。
概念解释
超时成因分组:下游响应慢(IO 等待)、同步设施等待不满足(Channel/Sync/锁)、未 hook 阻塞调用卡住调度、重计算占满 CPU。定位时先看协程状态与挂起点,再对照下游耗时与系统指标。慢请求埋点需记录开始时间、等待阶段与协程标识。
原理流程
- 从超时/慢请求日志提取 traceId、协程 ID 与耗时阶段。
- 导出对应协程状态与挂起位置。
- 对照下游调用耗时:确认是等待外部响应还是内部等待。
- 检查是否存在未 hook 阻塞点与 CPU 密集循环。
- 按成因调整超时、并发、阻塞点替代或计算优化。
代码或图示
卡顿分类
等待下游:IO 挂起,下游耗时偏高
等待同步:Channel / WaitGroup / 锁未满足
阻塞卡点:未 hook 调用拖住事件循环
计算占用:CPU 密集循环未让出
常见误区
- 超时一律加大超时阈值:不解决下游慢或阻塞根因。
- 只看接口总耗时:不拆分排队、等待下游与处理阶段。
追问
- 未 hook 阻塞点如何识别?答:06.5.7.7-010/020 与 06.5.7.12-002。
- 超时异常分类见哪里?答:06.5.7.10-006/014。
06.5.7.13-012 文件描述符与连接数如何观测?
一句话结论
fd 观测对比进程打开的文件描述符数与活跃连接数:正常应随连接数同步起落;fd 持续增长而连接数回落,提示连接泄漏;连接数飙升对照并发负载与下游容量判断。
概念解释
常驻服务的 fd 包括监听 Socket、已连接 Socket、下游连接、文件与管道。fd 上限受系统配置约束,耗尽后新连接失败。观测点:活跃连接数、下游连接占用、fd 总量与系统上限。连接归属与关闭规则见 06.5.7.8-005/006。
原理流程
- 采集活跃连接数、下游连接数与 fd 总量曲线。
- 负载回落后核对 fd 是否同步回落。
- 不回落则遍历连接/协程清单定位未关闭句柄。
- 检查系统 fd 上限配置与连接池上限是否匹配。
代码或图示
fd 观测对照
活跃连接数 ↔ 进程 fd 总量 ↔ 系统 fd 上限
连接回收后:三者应同步下降
泄漏特征:连接数回落,fd 仍持续增长
常见误区
- 只监控连接数不监控 fd:连接对象已释放但句柄未关闭时连接数看不出来。
- 忽略系统 fd 上限:进程内计数正常也可能被系统限制拒绝新句柄。
追问
- 系统 fd 上限在哪配置?答:部署环境的系统配置与进程资源限制;具体按 OS 规范核对。
- 连接池连接占用怎么看?答:池化连接单独统计借出/空闲数,与短连接区分。
06.5.7.13-013 指标采集应该落在框架层还是运行时层?
一句话结论
业务指标(吞吐、延迟、错误分类)落在框架/中间件层采集;运行时状态(协程数、连接数、资源趋势)通过适配层导出;Swow 核心提供状态查询能力,不直接绑定业务监控系统。
概念解释
分层原则:运行时提供可观测的状态与计数入口,框架层把这些状态映射到项目监控体系;业务埋点在请求管道中完成。不要在业务代码散落采集逻辑,统一在中间件/适配层接入,便于更换监控后端。
原理流程
- 框架中间件记录请求开始/结束与结果分类。
- 适配层周期采集协程数、连接数与运行时状态。
- 资源指标对接项目监控系统与告警规则。
- 指标命名与口径在项目文档中统一。
代码或图示
采集分层
框架/中间件:请求吞吐、延迟分位、业务错误分类
适配层:协程数、连接数、运行时状态
部署体系:CPU、内存、fd、系统负载
常见误区
- 在控制器里直接调用监控 SDK:采集逻辑散落,口径不一致。
- 期待运行时直接输出现成监控报表:报表与告警由框架/部署体系补齐。
追问
- 运行时状态查询 API 待确认项有哪些?答:协程遍历、状态字段、计数接口;以 API 文档与反射核对为准。
- 采集对性能的影响?答:周期采样而非逐请求重计算,关键路径避免锁与 IO。
06.5.7.13-014 性能基准对比如何保证口径可信?
一句话结论
对比必须在同环境、同下游、同场景、同口径下进行,包含预热与足够样本量;区分运行时差异、框架开销与业务逻辑差异,不把单次短测数值当作性能结论。
概念解释
可信对比控制变量:PHP 版本、扩展版本、OS、机器规格、下游版本与报文大小一致;并发档位、压测时长、采样方式相同;分别记录吞吐、延迟分位、错误率与资源占用。跨运行时对比时还要扣除框架与业务实现差异,避免不公平对照。
原理流程
- 固定环境基线并记录版本清单。
- 两版使用相同压测脚本与场景配置。
- 预热后采集足够样本,覆盖梯度与长稳。
- 按统一口径计算指标,标注差异来源与未控变量。
代码或图示
对比控制项
环境:PHP / 扩展 / OS / 机器规格一致
下游:同版本测试环境或同版本 mock
场景:报文大小、业务比例、并发档位一致
口径:预热规则、采样比例、分位计算方式一致
常见误区
- 一次压测定优劣:样本不足或环境差异会误导结论。
- 对比不同实现的代码:框架与业务优化混入运行时差异。
追问
- Swow 与 Swoole/FPM 性能对比口径见哪里?答:06.5.7.15-004/018;本页只讲方法。
- 基准数据如何留痕?答:脚本、环境版本、原始结果与对比表一并归档。
06.5.7.13-015 内存单调增长如何逐项排查?
一句话结论
内存增长按“缓存未失效 → 复用对象未清零 → 缓冲累积 → 对象/协程残留”顺序排查,每项对应可验证的复位或回收路径;先确认增长来源再决定优化手段。
概念解释
常见来源:进程级缓存只增不减;数组/计数器/模型复用时残留上次数据;Socket/Buffer 待发数据积压;协程与连接未回收导致对象持有链不释放。排查从内存趋势与分配热点入手,结合压测前后回落情况定位。
原理流程
- 确认增长是否随负载回落:不回落即为残留。
- 检查进程级缓存是否有失效与上限策略。
- 检查复用对象、数组、计数器复用时是否复位。
- 检查 Buffer/连接缓冲是否受背压与上限控制。
- 排查协程泄漏与异常路径对象持有链。
代码或图示
内存增长排查顺序
缓存只增不减 → 复用对象未清零 → 缓冲累积
→ 协程/连接残留 → 分配热点定位
常见误区
- 一上来升级 PHP 或加内存:不解决残留根因,扩容后继续增长。
- 混淆常驻基线与泄漏:平台期稳定的高内存是基线,单调增长才是问题。
追问
- 缓存上限怎么设?答:按内存预算与数据热度评估,配合失效策略;字典类只读缓存与请求结果缓存分开管理。
- Buffer 累积控制?答:06.5.7.6-015/020。
06.5.7.13-016 活跃协程数飙升有哪些常见成因?
一句话结论
协程数飙升常见于连接/任务无界并发、下游变慢导致等待协程堆积、连接或任务泄漏、生产者速率高于消费能力;定位时对照并发负载、下游状态与消费速率,区分积压与泄漏。
概念解释
健康形态:协程数随请求并发增减。飙升分组:上游并发过高(正常承载问题)、下游变慢(等待堆积)、消费能力不足(Channel 积压)、泄漏(回收路径失效)。需要并发闸门限制无界派生,避免慢下游把协程数推到内存与调度极限。
原理流程
- 采集协程数与并发请求、下游耗时的时间对照。
- 判断是否下游变慢导致等待协程堆积。
- 检查任务生产/消费速率差与通道积压量。
- 压测结束后核对协程数是否回落,不回落按泄漏处理。
- 必要时增加并发上限与排队策略。
代码或图示
飙升成因
无界派生:每请求/每任务直接开协程,无并发上限
下游变慢:IO 等待协程堆积
消费积压:生产快于消费,通道与协程滞留
资源泄漏:连接/任务未回收,协程不退出
常见误区
- 协程数越高并发越好:等待堆积同样表现为协程增长,吞吐未必提升。
- 只限制进程数不限制单进程并发:单进程内仍可被慢下游压垮。
追问
- 并发闸门怎么实现?答:应用层计数或信号量控制同时在跑的任务数;同步设施见 06.5.7.5。
- 通道积压如何观测?答:Channel 长度与读写可达性查询,见 06.5.7.4-012。
06.5.7.13-017 如何搭建问题复现环境?
一句话结论
复现环境按故障版本基线准备:相同 PHP/扩展/依赖版本、可控的下游 mock、并发注入脚本与观测采集;先复现最小路径,再逐步还原真实条件。
概念解释
复现环境目标是稳定触发问题而非完全等同生产:版本对齐,下游可控,故障注入点明确。常见手段:mock 下游延迟与错误、脚本施加梯度并发、固定报文样本。复现后保留脚本与配置,作为回归用例的基础。
原理流程
- 记录故障时版本清单:PHP、扩展、框架、依赖包。
- 准备测试下游:可控制延迟、错误与报文响应。
- 编写复现脚本:输入样本、并发档位与持续时长。
- 部署观测采集,按线上现象复现并记录现场。
- 修复后在同一脚本下验证问题消失。
代码或图示
复现环境要素
版本基线(与故障实例一致)
可控下游(延迟 / 错误 / 报文)
复现脚本(样本 / 并发 / 时长)
观测采集(协程 / 连接 / 内存 / 日志)
常见误区
- 直接在生产环境复现排查:扩大故障面。
- 复现条件不可控:问题时有时无,无法验证修复效果。
追问
- 无扩展环境能复现协程问题吗?答:不能;涉及调度与 IO 的问题必须在加载扩展的环境复现。
- 复现用例如何沉淀?答:转为集成测试或压测脚本纳入回归集,见 06.5.7.12-011。
06.5.7.13-018 故障现场需要留存哪些信息?
一句话结论
现场信息包括:版本与配置、监控曲线、错误与访问日志、协程/连接快照、下游状态、故障时间线与已采取操作;留存优先于重启,记录中不写入密钥等敏感信息。
概念解释
信息清单用于事后根因分析与复现:版本基线排除环境漂移;曲线定位爆发时间与影响范围;日志与快照关联卡点;下游状态区分内部与外部成因;时间线记录处置动作避免重复操作。敏感字段按脱敏规则处理。
原理流程
- 记录实例标识、PHP/扩展/框架/依赖版本与配置摘要。
- 导出 CPU、内存、协程、连接、fd 与错误率曲线。
- 留存相关时间窗口日志、traceId 样本与异常堆栈。
- 导出协程清单、连接表与通道/计数状态快照。
- 记录下游状态、处置动作与时间节点。
代码或图示
现场留存清单
版本配置:PHP / 扩展 / 框架 / 依赖 / 关键配置
监控曲线:CPU、内存、协程、连接、fd、错误率
日志快照:错误日志、慢请求、异常堆栈、traceId
运行时快照:协程清单、连接表、等待状态
外部状态:下游健康度、网络与部署变更记录
常见误区
- 只保存报错消息:缺少上下文与快照,无法回溯卡点。
- 留存完整报文与凭证:违反脱敏规则,见 06.5.7.10-018。
追问
- 快照导出名目有哪些?答:协程 ID/状态/挂起点、连接地址与空闲时长、通道长度;具体导出 API 待确认。
- 现场信息归档到哪里?答:项目故障记录与监控留存策略,按团队规范执行。
06.5.7.13-019 性能优化应该按什么顺序推进?
一句话结论
优化顺序为:先测量确认瓶颈,再处理阻塞点与连接复用,然后是批量化与计算优化,最后才考虑结构性调整;每步优化后复测对比,避免凭感觉改动。
概念解释
常见优化路径:消除未 hook 阻塞点 → 改善连接复用与池化 → 减少序列化/重复计算 → 批量合并下游调用 → 调整并发与资源配置。先优化测量数据指向的瓶颈,不预先调参;CPU 与 IO 瓶颈手段不同,避免把 IO 问题当计算问题处理。
原理流程
- 压测与观测确认瓶颈环节(IO 等待、下游、计算、调度)。
- 优先消除阻塞卡点与不合理的连接创建。
- 优化重复计算、序列化与对象分配。
- 合并批量调用,调整并发与缓冲配置。
- 复测指标,保留优化前后对比数据。
代码或图示
优化顺序
测量定位瓶颈 → 阻塞点 / 连接复用 → 计算与分配
→ 批量合并 → 并发与参数调优 → 复测验证
常见误区
- 未测量先调参数:调整方向缺乏依据。
- 一次性大改多处:无法归因哪项改动带来收益或副作用。
追问
- IO 密集与 CPU 密集优化手段差异?答:IO 侧改善等待与复用,CPU 侧减少计算量与并行扩容。
- 优化后如何确认无回归?答:功能回归 + 压测对比 + 长稳观察,指标口径见 06.5.7.13-007。
06.5.7.13-020 调试观测落地的自检清单有哪些?
一句话结论
清单覆盖协程与资源观测、压测指标口径、日志追踪、排障流程、调试扩展限制与现场留存;逐项确认采集点与责任人,未覆盖项纳入后续补齐计划。
概念解释
自检在原型阶段建立观测基线,上线前复核。每项确认:采集什么指标、从哪里采集、如何关联到请求、异常如何告警。运行时状态查询 API 不确定的条目标注待确认,在目标环境实测后固化。
原理流程
- 核对协程数、连接数、fd、资源趋势可采集。
- 核对吞吐、延迟分位、错误分类指标口径统一。
- 核对日志上下文与 traceId 贯穿,异常有记录。
- 核对排障流程、复现环境与现场留存清单就绪。
- 确认生产环境不加载调试扩展,待确认项登记跟踪。
代码或图示
观测自检清单
[ ] 协程数 / 连接数 / fd / 资源趋势可观测
[ ] 吞吐 / 延迟分位 / 错误率口径明确
[ ] 日志携带协程 ID 与 traceId,异常堆栈完整
[ ] 慢协程与超时可关联到具体挂起点
[ ] 压测脚本与基线数据归档
[ ] 复现环境与现场留存流程就绪
[ ] 生产不加载调试扩展,兼容限制已记录
常见误区
- 上线后再补观测:故障时缺少定位手段。
- 监控指标只看板不设告警规则:异常无人感知。
追问
- 待确认观测 API 如何闭环?答:隔离环境反射类方法、对照文档后更新清单,记录版本与日期。
- 观测能力与框架集成的边界?答:见 06.5.7.12-013,运行时提供状态,框架层完成采集映射。