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

06.5.7.10 错误处理与异常传播

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

06.5.7.10-001 Swow 体系的错误处理总体模型是什么?

一句话结论

Swow 倾向以抛出异常表达失败:底层组件方法在超时、关闭、网络错误等场景抛 Swow\Exception 及其子类,业务用 try/catch 捕获并按异常类型与错误码分流;与 Swoole 历史上 false 返回值加 errCode 的模式形成对照。

概念解释

异常携带类型、消息、错误码与堆栈;捕获时先按子类区分场景,再用错误码定位细分原因。基类、子类清单与错误码取值需以当前版本 API 文档为准(待确认)。既有 06.5.7.2 已对照过双方错误语义,本页聚焦落地写法与传播规则。

原理流程

  1. 调用 Socket/Channel/Sync 等组件方法进入可能失败的路径。
  2. 失败时扩展或库层抛出对应异常,携带错误码。
  3. 业务在协程体内 try/catch 捕获,按类型与错误码分流处理。
  4. 无法处理的异常向上传播,进入框架兜底或进程退出路径。

代码或图示

<?php
// 文档示例:异常捕获与分流骨架(未实测,异常子类与错误码待确认)
try {
    // 组件调用:读取 / 写入 / 等待
} catch (\Swow\SocketException $e) {
    // 网络类异常分支
} catch (\Swow\Exception $e) {
    // 其余 Swow 异常分支
}

常见误区

  • 沿用 Swoole 返回值判断习惯:Swow 侧失败多走异常,false 判断分支不会触发。
  • 只捕获基类丢弃细分信息:超时、EOF、关闭、网络错误需要分别处理。

追问

  • 异常基类与子类如何核对?答:反射 Swow\Exception 及其子类清单,对照 API 文档;本机未安装扩展,结论待确认。
  • 错误码从哪里读取?答:异常对象的 getCode();具体码值表以文档为准,不要凭记忆写死。

06.5.7.10-002 协程内抛出的异常如何向上传播?

一句话结论

异常在抛出点沿协程调用栈向上冒泡,被同协程内的 try/catch 捕获;未被捕获的异常停留在该协程的退出路径,父协程不会自动捕获子协程异常,跨协程结果需要通过 Channel、Sync 等设施显式收集。

概念解释

协程有独立执行栈,异常传播只沿当前协程栈向上,不跨协程边界。父协程派生子协程后继续执行,子协程内未捕获异常不会自动回到父协程的 catch 块。需要汇总异常时,由子协程把异常对象写入 Channel 或结果容器,父协程统一读取处理。

原理流程

  1. 协程体内某层调用抛出异常。
  2. 沿当前协程调用栈逐层向上查找匹配的 catch。
  3. 找到则在该层恢复执行;找不到则进入协程未捕获退出路径。
  4. 跨协程传播:子协程把异常放入通信设施,父协程在等待侧读取并处理。

代码或图示

<?php
// 文档示例:子协程异常经 Channel 回传父协程(未实测)
use Swow\Channel;
use Swow\Coroutine;

$errors = new Channel(8);
Coroutine::run(static function () use ($errors): void {
    try {
        // 业务调用
    } catch (\Throwable $e) {
        $errors->push($e);
    }
});
// 父协程从 $errors 读取异常对象并统一记录

常见误区

  • 在父协程外层包 try/catch 就以为能兜住子协程异常:跨协程边界不会自动冒泡。
  • 子协程抛异常后父协程仍按成功汇总:结果与错误必须分别收集。

追问

  • 未捕获异常的具体进程行为是什么?答:以当前版本文档与隔离环境实测为准(待确认);既有 06.5.7.3-009 已说明协程退出状态相关规则。
  • 如何让父协程等待子协程异常收敛?答:配合 WaitGroup/WaitReference 等待全部任务结束,再统一读取错误容器;计数规则见 06.5.7.5。

06.5.7.10-003 try/catch 应该放在协程的什么位置?

一句话结论

兜底 catch 应放在连接协程或任务协程的最外层,保证协程体内任何未处理异常都被记录;业务局部 catch 只用于可恢复的细分场景,不要在底层工具函数里吞掉异常。

概念解释

位置分两层:业务层 catch 处理可预期错误(如参数校验失败、下游超时降级);协程最外层 catch 作为最后防线,记录异常与上下文后正常退出协程,避免未捕获异常直接进入进程退出路径。局部 catch 后若不重新抛出,必须确认错误已被妥善处理。

原理流程

  1. 派生连接/任务协程,协程体最外层包裹兜底 try/catch。
  2. 内部业务代码按场景局部 catch 可恢复错误。
  3. 不可恢复异常冒泡到最外层,记录日志与上下文。
  4. 兜底块完成资源清理后协程退出。

代码或图示

<?php
// 文档示例:协程最外层兜底结构(未实测)
Coroutine::run(static function (): void {
    try {
        // 业务处理:读取、解析、调用下游、回写
    } catch (\Throwable $e) {
        // 记录异常:类型、错误码、连接/请求标识、堆栈
    } finally {
        // 资源清理:关闭连接、归还连接、释放缓冲
    }
});

常见误区

  • catch 只写在工具函数内部且不重抛:上层无法感知失败,形成静默失败。
  • 最外层不兜底:一个未预期异常决定整个协程乃至进程的退出行为。

追问

  • 兜底 catch 应该捕获 \Throwable 还是 \Exception?答:需同时覆盖 Error 类致命错误时用 \Throwable;具体策略按框架约定,避免遗漏 TypeError 等错误。
  • 兜底后协程还能继续服务吗?答:连接级协程通常记录后退出,由新连接协程承接;长生命周期协程需评估状态是否已损坏。

06.5.7.10-004 未捕获异常会导致进程退出吗?

一句话结论

未捕获异常的影响范围以当前版本实现为准(待确认):需在隔离环境分别验证子协程未捕获、主协程未捕获两种情形;工程上应在协程最外层兜底,不依赖运行时的默认行为来保证服务存活。

概念解释

主协程是脚本最外层,其未捕获异常通常直接表现为进程错误退出;子协程未捕获异常是否终止整个进程、是否仅结束该协程,不同运行时版本行为可能不同。面试与设计中不能假设“子协程异常不影响主进程”,必须实测并在代码层兜底。

原理流程

  1. 在隔离环境构造子协程抛未捕获异常的用例。
  2. 观察进程是否退出、其他协程是否继续调度、退出码与日志表现。
  3. 再构造主协程未捕获异常用例对照。
  4. 把实测结论记录到运行手册,代码层按最严格假设兜底。

代码或图示

# 隔离环境验证命令示例(本机未安装扩展,待实际环境执行)
php -r "require 'vendor/autoload.php';"
php --ri swow

常见误区

  • 凭其他协程运行时经验推断 Swow 行为:未实测前结论标注待确认。
  • 把“进程没立刻退出”当成异常已被妥善处理:可能存在协程残留或状态损坏。

追问

  • 如何核对官方对未捕获异常的说明?答:查 API 文档异常章节与扩展仓库 issue;结合 php --ri swow 与版本号记录核对日期。
  • 主协程退出对子协程的影响?答:既有 06.5.7.3-011/012 已说明主协程退出规则;常驻服务需由监听循环或等待设施维持主协程存活。

06.5.7.10-005 Swow 的异常类体系与错误码如何组织?

一句话结论

异常体系以 Swow\Exception 为基类,按组件细分出 Socket、Channel 等子类;错误码区分超时、关闭、EOF、网络错误等场景;完整子类清单与码值表以当前版本文档为准(待确认)。

概念解释

设计上“类型定大类、错误码定细分”:先 catch 子类判断是网络、通道还是同步设施问题,再读错误码区分具体失败原因。异常消息用于人读,错误码用于程序分支;不要只靠消息文本匹配错误。

原理流程

  1. 查 API 文档或反射列出 Swow\Exception 子类。
  2. 按组件建立 catch 分支顺序:具体子类在前,基类在后。
  3. 读取 getCode() 对照错误码表做细分判断。
  4. 记录时同时保存类型、错误码、消息与堆栈。

代码或图示

<?php
// 文档示例:按子类与错误码分流(码值待确认)
try {
    // 组件调用
} catch (\Swow\ChannelException $e) {
    $code = $e->getCode(); // 对照文档区分超时 / 关闭
} catch (\Swow\SocketException $e) {
    $code = $e->getCode(); // 对照文档区分超时 / EOF / 网络错误
}

常见误区

  • 用异常消息文本判断错误:消息可能随版本调整,错误码更稳定。
  • 子类顺序写反:先 catch 基类会吞掉后面的细分分支。

追问

  • 错误码表在哪里核对?答:API 文档异常章节或扩展源码中的常量定义;本机未安装扩展,无法反射核对(待确认)。
  • 第三方库抛的异常如何归类?答:按其自身命名空间与基类处理,不要混入 Swow 异常分支;记录时保留原始类型。

06.5.7.10-006 取消、超时与关闭分别对应什么异常语义?

一句话结论

超时表示等待条件在时限内未满足;关闭表示通道/连接被主动关闭后再操作;取消表示任务被显式终止;三者异常类型或错误码不同,处理策略也不同,需分别识别。

概念解释

超时后被等待的任务可能仍在运行;关闭后等待者以关闭类异常唤醒;取消通常伴随资源清理。业务要区分“等待失败”与“任务失败”:超时不等于下游一定失败,关闭不等于协议错误。具体异常子类与码值待确认。

原理流程

  1. 调用带超时的等待/读写方法,记录等待类型。
  2. 触发超时:捕获超时类异常,决定重试、降级或关闭。
  3. 触发关闭:捕获关闭类异常,清理残留状态。
  4. 任务被取消:按取消语义停止后续操作并释放资源。

代码或图示

异常语义对照
超时:等待条件未在时限内满足,任务可能仍在运行
关闭:对象被关闭后操作,等待者以关闭异常唤醒
EOF:对端有序关闭读方向,连接进入收尾
取消:任务被显式终止,需联动资源清理

常见误区

  • 超时一律重试:非幂等操作重试会放大副作用。
  • 关闭异常按系统错误告警:多为正常收尾路径,日志级别应区分。

追问

  • 超时后被等待任务继续运行怎么办?答:任务自身需有超时感知与退出条件;残留任务的泄漏排查见 06.5.7.13。
  • 如何识别 EOF 与异常断开?答:按异常子类与错误码区分;判定 API 待确认,以文档为准。

06.5.7.10-007 异常路径下资源回收如何与异常处理联动?

一句话结论

资源回收放在 finally 或 defer 兜底块,与业务成功路径共用同一套清理逻辑;异常分支只负责记录与决策,不重复编写关闭代码,避免异常路径泄漏 fd、连接与缓冲。

概念解释

既有 06.5.7.8 已梳理资源归属与清理规则,本页补充异常视角:catch 块处理错误,finally 块保证回收;连接归还、缓冲释放、计数递减必须在所有分支一致执行。异常对象本身持有堆栈,记录后再释放引用。

原理流程

  1. 资源获取后立即规划清理点:连接、Buffer、计数、锁。
  2. 主流程与异常流程都经过同一兜底清理块。
  3. catch 块记录上下文与错误,不做重复关闭。
  4. 清理完成后协程退出,资源归属回到池化或运行时。

代码或图示

<?php
// 文档示例:异常与清理分离(未实测)
try {
    // 业务调用,可能抛异常
} catch (\Throwable $e) {
    // 记录日志与上下文
    throw $e; // 或按策略降级,不吞异常
} finally {
    // 关闭连接 / 归还连接 / 释放 Buffer / 递减计数
}

常见误区

  • 在 catch 里写关闭逻辑而 finally 为空:部分异常路径会绕过清理。
  • 清理代码自身再抛异常覆盖原异常:清理失败需单独记录,避免掩盖根因。

追问

  • defer 与 finally 怎么选?答:按 Swow 协程内 defer 注册时机与执行规则选择;既有 06.5.7.3-016 已说明 defer 执行时机。
  • 连接池归还失败怎么办?答:归还异常应记录并标记连接不可用,必要时销毁该连接,避免脏连接回流池中。

06.5.7.10-008 异常日志与告警应该落在什么位置?

一句话结论

日志在异常发生的最外层兜底点记录,携带异常类型、错误码、消息、堆栈与请求/连接上下文;告警按错误级别分流,业务可恢复错误走日志,系统级与大面积失败才触发告警。

概念解释

上下文包括协程 ID、连接标识、下游地址、请求标识(traceId)等,便于跨协程串联。日志级别区分:预期内的参数/业务错误为 warn,下游超时与网络异常为 error,未捕获兜底与进程级故障为 critical。具体日志接口来自框架或日志库,不属于 Swow 运行时。

原理流程

  1. 异常进入兜底 catch,组装上下文快照。
  2. 按异常类型与错误码判定日志级别。
  3. 记录类型、码值、消息、堆栈与上下文。
  4. 达到告警阈值的错误上报监控,其余仅落日志。

代码或图示

<?php
// 文档示例:异常日志上下文组装(未实测,日志接口按框架约定)
// $logger->error('request failed', [
//     'exception' => get_class($e),
//     'code' => $e->getCode(),
//     'message' => $e->getMessage(),
//     'trace' => $e->getTraceAsString(),
//     'coroutineId' => $coId,
//     'connection' => $peer,
// ]);

常见误区

  • 只记录消息不记堆栈:无法定位抛出点。
  • 所有异常都告警:告警疲劳后真正的系统故障被淹没。

追问

  • 协程 ID 如何获取进日志?答:通过协程对象的 ID 方法;方法名见 06.5.7.3,上下文传递规则见 06.5.7.8。
  • 日志库本身要协程安全吗?答:需要;判断方法见 06.5.7.8-009,避免日志写入成为阻塞点。

06.5.7.10-009 什么是静默失败,如何避免?

一句话结论

静默失败指异常被空 catch 吞掉、错误被默认值掩盖、失败路径无日志无监控;避免方式是每个 catch 都明确处理或重抛,失败必须留痕,默认值只用于可证明安全的降级场景。

概念解释

典型写法:catch (\Throwable $e) {} 空块、catch 后返回空数组且不记录、下游失败被缓存默认值顶替。常驻服务中这类问题会在长尾并发下才暴露,排查成本很高。代码评审应把“catch 是否留痕、是否重抛”作为检查项。

原理流程

  1. 审查所有 catch 块:确认处理动作或重抛路径。
  2. 空 catch 必须补充日志或改为不捕获。
  3. 降级返回默认值时记录降级原因与上下文。
  4. 关键失败路径接入指标与告警,避免只能靠日志发现。

代码或图示

<?php
// 反例与正例对照(文档示例,未实测)
// 反例:catch (\Throwable $e) { }
// 反例:catch (\Throwable $e) { return []; }

// 正例:记录后按策略重抛或显式降级
catch (\Throwable $e) {
    $logger->warning('downstream fallback', ['code' => $e->getCode()]);
    return $fallback; // 降级值需业务确认安全
}

常见误区

  • 认为“不报错就是成功”:吞异常后上游继续按成功流程处理,数据更危险。
  • 把防御式编程写成空 catch:防御应体现在输入校验与显式降级。

追问

  • 哪些场景允许返回默认值?答:结果非关键、默认值可被业务接受且已记录降级;核心交易链路不允许静默降级。
  • 代码中如何批量排查空 catch?答:静态搜索 catch 块内只有注释或空语句的位置,逐一补处理策略。

06.5.7.10-010 父协程如何收集子协程抛出的异常?

一句话结论

通过共享结果容器(Channel 或上下文数组)由子协程写入异常、父协程在等待收敛后统一读取;配合 Sync 等待设施确保所有任务结束后再汇总,避免漏读。

概念解释

收集结构分成功结果与错误容器两路:子协程成功写结果,异常写错误容器;父协程等待全部任务完成后,先检查错误容器再决定整体成败。容器的并发写入安全由 Channel 或同步保护保证,规则见 06.5.7.4 与 06.5.7.8。

原理流程

  1. 创建结果 Channel 与错误 Channel(或带锁容器)。
  2. 派生子协程,内部 try/catch:成功写结果,异常写错误容器。
  3. 父协程用 WaitGroup/WaitReference 等待全部任务收敛。
  4. 读取错误容器,按异常类型汇总失败原因并记录。

代码或图示

<?php
// 文档示例:并发任务异常收集骨架(未实测)
use Swow\Channel;
use Swow\Coroutine;
use Swow\Sync\WaitGroup;

$wg = new WaitGroup();
$errors = new Channel(8);
foreach ($tasks as $task) {
    $wg->add();
    Coroutine::run(static function () use ($task, $wg, $errors): void {
        try {
            // 执行 $task
        } catch (\Throwable $e) {
            $errors->push($e);
        } finally {
            $wg->done();
        }
    });
}
$wg->wait(5000);
// 读取 $errors 汇总失败

常见误区

  • 不等任务结束就读错误容器:漏读仍在运行协程的异常。
  • 异常写入容器失败(如通道满):需确认容量或改用无界/带超时写入策略。

追问

  • 部分任务失败时整体如何决策?答:按业务语义定义成败口径:全部成功、多数成功或允许部分失败;决策逻辑放在父协程汇总层。
  • 异常对象跨协程传递安全吗?答:对象引用在进程内共享,子协程不再修改其状态即可;注意不要把请求态数据挂到异常对象上。

06.5.7.10-011 主协程异常与进程退出码有什么关系?

一句话结论

主协程未捕获错误通常表现为进程终止并产生退出码;业务应在主流程显式处理致命错误、记录日志后按约定退出码结束,避免把未处理错误的默认退出行为暴露给部署体系。

概念解释

进程退出码被 supervisor、容器编排与部署脚本读取,用于判断重启与告警。未捕获异常导致的退出可能没有结构化日志;显式退出路径可以保证日志落盘、资源清理与退出码约定一致。退出码取值规则按部署体系约定,不属于 Swow 运行时。

原理流程

  1. 主流程包裹顶层 try/catch/Error。
  2. 致命错误记录日志并完成必要清理。
  3. 按错误类别返回约定退出码。
  4. 部署体系根据退出码决定重启或告警。

代码或图示

# 部署侧观察退出码示例(按实际部署体系调整)
# supervisor / 容器日志中查看进程退出状态与重启记录

常见误区

  • 常驻服务依赖默认退出行为:日志未落盘就退出,线上无法追溯根因。
  • 清理失败影响退出码:清理问题应单独记录,业务失败与清理失败的退出口径分开定义。

追问

  • 进程被信号终止与异常退出如何区分?答:信号终止由部署与信号处理路径记录;异常退出由顶层错误路径记录;两类信息在日志中分开标注。
  • 退出码规范在哪里维护?答:项目运维文档与部署脚本约定;本页不定义具体码值。

06.5.7.10-012 如何对接框架层的异常处理器?

一句话结论

Swow 运行时本身不提供业务异常处理器;框架在请求协程的中间件管道中注册异常监听器或错误处理器,把底层异常转换为统一错误响应;对接时要区分运行时异常与业务异常的归属层。

概念解释

典型框架流程:请求进入协程 → 中间件/控制器抛业务异常 → 框架异常处理器捕获 → 按异常类型映射响应状态与错误体 → 记录日志。运行时层面的 Socket/Channel 异常在适配层转换为框架可识别错误。自研框架时需在连接协程最外层补同样的兜底。

原理流程

  1. 框架引导时注册全局异常处理器与错误监听。
  2. 请求协程管道内抛出的异常被处理器拦截。
  3. 处理器映射 HTTP 状态码、错误码与响应体。
  4. 不可恢复异常记录堆栈并按策略返回兜底响应。

代码或图示

框架异常处理链路
请求协程 → 中间件 → 控制器/业务
  → 抛出业务或运行时异常
    → 框架异常处理器:映射状态码 / 错误体 / 日志
      → 响应回写

常见误区

  • 把框架处理器当成 Swow 扩展能力:换框架后对接方式可能不同。
  • 业务异常与系统异常混用同一响应格式:客户端无法区分可重试与不可重试错误。

追问

  • 框架异常处理器如何拿到协程上下文?答:经框架请求对象与上下文容器传递;上下文隔离规则见 06.5.7.8。
  • 自研服务如何补兜底?答:在连接/任务协程最外层 catch \Throwable,记录后生成统一错误响应。

06.5.7.10-013 异常类型如何映射为 HTTP 状态码与业务错误码?

一句话结论

映射分两层:框架/协议层把异常转为 HTTP 状态码,业务层定义对外错误码;底层 Swow 异常通常先转为内部错误,不直接把运行时错误码暴露给客户端。

概念解释

HTTP 状态码表达协议与请求处理结果(4xx/5xx),业务错误码表达具体失败原因(参数错误、下游失败、限流等)。映射规则集中在异常处理器中维护:参数类异常映射 4xx,下游与系统类映射 5xx 并记录完整堆栈;对外响应不暴露内部错误码与堆栈细节。

原理流程

  1. 定义业务异常类型与对应错误码表。
  2. 异常处理器按类型映射 HTTP 状态码与对外错误码。
  3. 底层运行时异常包装为内部错误,记录堆栈但响应脱敏。
  4. 响应体携带稳定错误码与可读消息,便于客户端处理。

代码或图示

映射分层示例
参数校验异常 → 400 + 参数错误码
未授权 → 401 / 403 + 对应业务码
下游超时 / 系统异常 → 5xx + 内部错误码,堆栈仅落日志

常见误区

  • 把 Swow 错误码直接作为对外错误码:码值含义随版本变化,且暴露内部实现。
  • 所有异常都返回 500:客户端无法区分可重试错误,重试策略失控。

追问

  • 错误码表维护在哪里?答:项目代码中的异常类与映射配置;新增异常类型同步登记。
  • 异常消息能否直接返回客户端?答:业务消息可返回;内部错误消息与堆栈必须脱敏,安全要求见项目安全规范。

06.5.7.10-014 网络类异常如何细分为超时、EOF、关闭与协议错误?

一句话结论

网络异常先按子类归类,再按错误码区分等待超时、对端 EOF、连接关闭、连接重置与协议解析错误;各分支记录不同信息并采取不同连接处置策略。

概念解释

超时:等待读写未在时限内完成;EOF:对端有序关闭;关闭:本地或通道主动关闭;RST:异常断开;协议错误:字节流不符合报文规则。前两类偏连接生命周期,协议错误偏业务解析。细分判定依赖异常子类与错误码表(待确认)。

原理流程

  1. catch 网络类异常,读取类型与错误码。
  2. 对照码值表归类到超时/EOF/关闭/RST/协议错误。
  3. 按类别记录日志级别与上下文。
  4. 决定关闭连接、重试读取还是降级响应。

代码或图示

<?php
// 文档示例:网络异常分类分支(码值与子类待确认)
// catch (\Swow\SocketException $e) {
//     switch ($e->getCode()) {
//         case 超时码:   // 记录超时,按策略关闭或重试
//         case EOF码:   // 有序收尾
//         case 关闭码:  // 本地关闭路径
//         default:      // 网络异常,记录并关闭
//     }
// }

常见误区

  • 网络异常一律关闭连接:EOF 与关闭是正常收尾,应区分日志与处置。
  • 协议错误不记录原始字节:缺少报文样本难以复现解析问题(注意脱敏)。

追问

  • 协议解析错误在哪一层捕获?答:Buffer 分帧与反序列化层;分帧流程见 06.5.7.9-008/009。
  • RST 与 EOF 对应用户体验差异?答:EOF 是有序断开,RST 常伴随未读完数据;具体连接状态以系统行为与文档为准。

06.5.7.10-015 重试与降级在异常处理流程中处于什么位置?

一句话结论

重试只针对可重试、幂等的失败(如网络抖动、超时),降级针对部分功能可容忍失败的场景;两者都在异常分类之后决策,并受次数、退避与超时预算约束。

概念解释

重试前提:操作幂等、失败原因可恢复、下游仍有容量;非幂等写操作盲目重试会产生重复副作用。降级前提:存在安全默认值或简化路径,并已记录降级原因。重试与降级策略属于业务/框架层,Swow 运行时不提供默认重试。

原理流程

  1. 异常分类后判断是否可重试。
  2. 可重试:按次数与退避策略再次调用,纳入整体超时预算。
  3. 不可重试但可降级:返回降级结果并记录。
  4. 都不满足:向上抛出或返回错误响应。

代码或图示

异常处置决策
异常分类 → 可重试且幂等?→ 是:限次重试 + 退避
  ↓ 否
可安全降级?→ 是:降级结果 + 记录
  ↓ 否
向上抛出 / 错误响应

常见误区

  • 对支付、下单等写操作直接重试:未确认幂等性前不得重试。
  • 重试不设总超时:下游故障时重试放大流量,拖垮双方。

追问

  • 退避策略有哪些常见形式?答:固定间隔、线性/指数退避加抖动;具体实现按项目框架约定,本页不展开算法。
  • 重试期间连接如何处理?答:重试走新的或归还后的连接;旧连接按异常路径关闭,不要在异常连接上反复重试。

06.5.7.10-016 异常未妥善处理会造成哪些协程泄漏与挂起残留?

一句话结论

异常路径下未关闭的连接、未释放的缓冲、未 done 的同步计数与未收集的异常容器,都会造成协程挂起残留与资源泄漏;泄漏表现与定位手段见 06.5.7.13,本页梳理成因。

概念解释

典型成因:catch 后协程提前退出但等待计数未 done,导致父协程永久挂起;连接未关闭导致 fd 与缓冲残留;异常对象未被读取导致 Channel 积压。这些问题在并发压测与长尾请求下才明显,平时单测不易暴露。

原理流程

  1. 梳理每条异常路径的资源与计数操作。
  2. 确认 finally 块完成关闭、归还与 done。
  3. 确认错误容器有消费方,不会积压无界增长。
  4. 压测后对照活跃协程数、fd 数与内存趋势验证无残留。

代码或图示

<?php
// 文档示例:异常路径计数必须释放(未实测)
$wg->add();
try {
    // 业务,可能抛异常
} catch (\Throwable $e) {
    $errors->push($e);
} finally {
    $wg->done(); // 无论成败都释放计数
}

常见误区

  • 只在成功路径调用 done:异常路径漏 done 会挂起等待方。
  • 错误 Channel 无消费方:异常积压后协程与内存逐步增长。

追问

  • 漏 done 的典型表现是什么?答:父协程 wait 永久挂起,任务列表残留;定位见 06.5.7.5-010 与 06.5.7.13。
  • 如何在测试中覆盖异常路径?答:构造下游超时与异常注入用例,断言资源计数与协程数回落。

06.5.7.10-017 编程错误(Error)与运行时异常在处理上如何区分?

一句话结论

Exception 表达可预期的运行时失败,Error(如 TypeError、调用未定义方法)多为代码缺陷;兜底层应一并捕获记录,但 Error 类问题原则上要在开发测试阶段修复,不能靠线上 catch 掩盖。

概念解释

协程代码中的类型错误、空对象调用等会触发 Error;这类错误与网络超时性质不同,重试或降级没有意义。线上兜底捕获是为了记录完整堆栈与避免进程无日志退出,根因必须回到代码修复。捕获 \Throwable 可同时覆盖两者。

原理流程

  1. 区分异常来源:运行时环境失败 vs 代码缺陷。
  2. 运行时异常走重试/降级/错误响应路径。
  3. Error 类问题记录堆栈并在缺陷清单中跟踪修复。
  4. 测试阶段用类型声明与静态分析前置发现同类问题。

代码或图示

<?php
// 文档示例:区分异常记录(未实测)
catch (\Swow\Exception $e) {
    // 运行时失败:按业务策略处理
} catch (\Error $e) {
    // 代码缺陷:记录 critical 堆栈,进入缺陷修复流程
}

常见误区

  • 把 Error 当业务异常返回 4xx:客户端收到的语义与实际根因不符。
  • 线上兜底后不回溯修复:缺陷随流量累积,故障面扩大。

追问

  • 静态分析能前置发现哪些 Error?答:类型不匹配、未定义方法/属性、空值调用等;按项目工具链配置。
  • 捕获 \Throwable 有什么风险?答:可能掩盖致命错误;需在评审与日志级别上区分处理。

06.5.7.10-018 记录异常时如何避免泄露敏感信息?

一句话结论

日志与对外响应只记录必要上下文:异常类型、错误码、追踪标识与脱敏后的请求摘要;密码、令牌、完整报文与个人信息不得进入日志,下游地址按规范脱敏。

概念解释

常驻服务日志长期保留,敏感信息一旦落盘即扩大泄露面。异常消息与堆栈一般不含业务密钥,但请求参数、头部、报文中可能携带凭证。记录前对字段做白名单或脱敏处理;对外错误响应同样不回显内部堆栈与详细路径。

原理流程

  1. 定义日志字段白名单与脱敏规则。
  2. 异常上下文组装时过滤敏感头部与参数。
  3. 对外错误体只含稳定错误码与可读消息。
  4. 定期审查日志样本,确认无敏感字段残留。

代码或图示

日志保留:异常类型、错误码、traceId、协程 ID、脱敏后的下游标识
禁止记录:密码、令牌、Cookie、完整身份证/手机号、完整报文

常见误区

  • 为排障记录全部请求体:敏感数据未脱敏即落盘。
  • 把内部错误消息直接返回前端:可能泄露路径、库版本与 SQL 片段。

追问

  • 下游地址如何脱敏?答:按项目规范隐藏凭证部分,保留主机与接口路径用于排障。
  • 排障需要完整报文时怎么办?答:在受控环境复现并临时记录,问题关闭后清理;不在生产默认开启全量报文日志。

06.5.7.10-019 测试中如何覆盖异常路径并断言错误处理?

一句话结论

测试需覆盖超时、关闭、EOF、下游异常等分支,断言异常类型/错误码、响应状态、资源回收与日志记录;异常路径用例与正常用例分列,避免只覆盖成功流程。

概念解释

单元测试针对可隔离的业务逻辑;协程环境下的集成测试需要真实或 mock 的下游,验证挂起、唤醒与回收。断言点包括:抛出的异常类型、错误码、返回降级值、连接/计数释放、关键日志条目。测试环境是否安装扩展以实际环境为准(本机未安装,用例为设计说明)。

原理流程

  1. 列出业务涉及的异常分类与处置策略。
  2. 为每类失败构造注入点:mock 下游超时、关闭连接、返回错误。
  3. 断言异常被正确分类与记录,资源计数回落。
  4. 回归测试中保留异常用例,防止后续改动回退静默失败。

代码或图示

异常测试清单
超时分支:断言超时异常类型 / 重试次数 / 降级结果
关闭分支:断言连接回收与计数释放
协议错误:断言错误响应与日志上下文
兜底分支:断言未捕获异常被记录且协程正常退出

常见误区

  • 测试只验证“不抛异常”:未断言异常被正确处理与记录。
  • 异常用例依赖真实网络抖动:应使用可控注入点,保证测试可重复。

追问

  • 协程环境测试如何搭建?答:在安装扩展的环境运行集成测试;CI 环境准备见 06.5.7.12。
  • 日志断言怎么做?答:通过测试用日志收集器检查级别、错误码与上下文字段,而不是匹配消息文本。

06.5.7.10-020 落地一套异常处理规范需要检查哪些条目?

一句话结论

检查条目覆盖:异常分类体系、捕获位置、传播规则、资源兜底、日志告警、对外映射、静默失败排查、测试覆盖与留痕记录;逐条落地后形成项目内可执行的错误处理规范。

概念解释

规范应回答:哪些异常由谁捕获、跨协程如何收集、失败如何记录与告警、对外返回什么、异常路径资源如何回收。运行时默认行为不确定的部分标注待确认,在目标环境实测后固化结论。

原理流程

  1. 梳理现有代码的 catch 块与返回值判断分支。
  2. 建立异常类型、错误码与响应映射表。
  3. 统一协程最外层兜底与资源兜底写法。
  4. 补充异常测试用例,纳入评审检查项与回归集。

代码或图示

异常处理自检清单
[ ] 每个 catch 有明确处理或重抛,无空 catch
[ ] 协程最外层兜底捕获并记录 \Throwable
[ ] 跨协程异常有显式收集容器与消费方
[ ] finally/defer 覆盖连接、缓冲、计数回收
[ ] 日志含类型、码值、上下文,敏感信息脱敏
[ ] 对外响应映射稳定错误码,不暴露堆栈
[ ] 异常路径有测试用例与资源回收断言

常见误区

  • 规范只写原则不落代码检查项:评审与回归阶段无法执行。
  • 把待确认的运行时行为写成确定结论:需实测后更新规范文档。

追问

  • 规范文档放在项目哪里维护?答:项目工程规范目录;与框架异常处理器实现保持同步。
  • 运行时行为待确认项如何闭环?答:记录验证命令(php --ri swow、反射、隔离环境复现)与核对日期,结论确认后更新条目。