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

04.5.2.10 错误处理与异常体系演进

所属:全栈开发面试题库 / 04 后端语言与运行时 / 04.5 PHP / 04.5.2 PHP 新版本特性与运行时演进

04.5.2.10-001 Throwable 在异常体系中处于什么位置?

一句话结论

Throwable 是引擎定义的根接口,Error 与 Exception 都实现它;只有 Throwable 类型的对象才能被 catch 捕获,也才能通过 throw 抛出。

概念解释

8.0 之前体系以 Exception 为中心,部分引擎错误无法被捕获;8.0 起统一到 Throwable 根接口下:Exception 承载业务与用户态异常,Error 承载引擎级错误。catch (Throwable $e) 可以同时接住两类,但业务代码通常按更具体的类型分别处理。

原理流程

  1. 抛出点生成实现 Throwable 的对象。
  2. 调用栈向上匹配 catch 类型。
  3. 匹配 Throwable 可覆盖 Error 与 Exception 两个分支。

代码或图示

function divide(int $a, int $b): int {
    if ($b === 0) {
        throw new DivisionByZeroError('division by zero');
    }
    return intdiv($a, $b);
}

try {
    divide(1, 0);
} catch (Throwable $e) {
    echo get_class($e), ': ', $e->getMessage(), PHP_EOL;
}

常见误区

  • 以为 catch (Exception $e) 能接住所有错误:引擎级 Error 不继承 Exception,需要 Throwable 或对应 Error 类型。
  • 抛出非 Throwable 对象:throw 只接受 Throwable,其他类型会触发致命错误。

追问

  • Throwable 可以直接被业务类实现吗?答:不建议也通常不允许直接实现;业务异常应继承 Exception 子类,引擎错误由内置 Error 子类承载。
  • 方法返回类型能声明 Throwable 吗?答:返回类型只能是类或接口;Throwable 作为接口可用于返回约束,具体以类型声明规则为准。

04.5.2.10-002 Error 层级主要有哪些内置子类?

一句话结论

本机 8.5.9 实测:TypeError、ArithmeticError、CompileError、ValueError、UnhandledMatchError 直接或间接继承 Error;ArgumentCountError 继承 TypeError,DivisionByZeroError 继承 ArithmeticError,ParseError 继承 CompileError。

概念解释

Error 分支覆盖类型不匹配、参数数量错误、算术错误、编译解析错误、取值非法等引擎级问题。掌握层级有助于精确 catch:先捕获具体子类,再向上兜底到 Error 或 Throwable。

原理流程

  1. 识别错误场景属于类型、参数、算术、解析还是取值非法。
  2. 对照层级选择最具体的 catch 类型。
  3. 未匹配的 Error 继续向上传播。

代码或图示

$hierarchy = [
    TypeError::class => Error::class,
    ArgumentCountError::class => TypeError::class,
    ArithmeticError::class => Error::class,
    DivisionByZeroError::class => ArithmeticError::class,
    CompileError::class => Error::class,
    ParseError::class => CompileError::class,
    UnhandledMatchError::class => Error::class,
    ValueError::class => Error::class,
];

foreach ($hierarchy as $child => $parent) {
    echo $child, ' extends ', $parent, PHP_EOL;
}

常见误区

  • 以为 ArgumentCountError 直接继承 Error:它实际是 TypeError 的子类。
  • 把 ParseError 与运行期 TypeError 混为一谈:解析错误发生在编译/求值阶段,类型错误发生在调用绑定期。

追问

  • ValueError 与 TypeError 区别?答:类型错误是实参类型不匹配;ValueError 是类型合法但取值非法(如非法格式参数),具体场景以内置函数文档为准。
  • 升级版本后层级会变吗?答:可能新增子类;上线前用 class_parents() 探针复核目标版本的继承链。

04.5.2.10-003 Exception 层级与内置基类如何组织?

一句话结论

Exception 是用户态异常的根类,其下分为 LogicException(编程期可预见)与 RuntimeException(运行期环境/状态问题)两大支,内置子类覆盖索引、长度、范围、IO、PDO 等常见场景。

概念解释

LogicException 表示代码逻辑上本应避免的问题(如非法参数、未定义方法);RuntimeException 表示执行过程中受环境影响出现的问题(如外部服务失败、状态非法)。业务自定义异常通常继承这两个分支之一。

原理流程

  1. 按问题性质选择基类:可预见的逻辑错误继承 LogicException,环境/状态问题继承 RuntimeException。
  2. 在基类下定义业务异常子类,携带错误码与上下文。
  3. catch 时先匹配业务子类,再按基类兜底。

代码或图示

class OrderNotFoundException extends RuntimeException {}
class InvalidQuantityException extends LogicException {}

function reserve(int $quantity): void {
    if ($quantity < 1) {
        throw new InvalidQuantityException('quantity must be >= 1');
    }
    if ($quantity > 100) {
        throw new OrderNotFoundException('reservation not available');
    }
}

try {
    reserve(0);
} catch (LogicException $e) {
    echo 'logic: ', $e->getMessage(), PHP_EOL;
} catch (RuntimeException $e) {
    echo 'runtime: ', $e->getMessage(), PHP_EOL;
}

常见误区

  • 所有自定义异常都直接继承 Exception:丢失了 Logic/Runtime 的语义分层,catch 粒度变粗。
  • 把外部依赖超时归为 LogicException:外部环境失败属于运行期异常。

追问

  • 内置 Exception 子类有哪些?答:InvalidArgumentException、OutOfRangeException、LengthException、LogicException、RuntimeException、BadMethodCallException 等;完整清单以本机 get_declared_classes() 过滤 Exception 父类为准。
  • 业务异常需要携带哪些上下文?答:错误码、关联业务标识、上下文数组;避免在异常对象中保存敏感数据。

04.5.2.10-004 8.0 前后内部函数的错误行为发生了什么迁移?

一句话结论

PHP 8.0 起部分内部函数对非法入参从产生 warning/notice 逐步改为抛出 TypeError/ValueError,类型与参数校验在绑定期或调用期以异常形式暴露;具体迁移清单以官方迁移指南为准。

概念解释

旧版本中许多内部函数入参非法时只产生告警并返回 false,调用方容易漏判;8.0 强化类型校验后,更多场景直接抛 Error 分支异常。迁移到 8.x 时,旧式 === false 判断可能被异常路径取代,需要同步调整捕获与容错逻辑。

原理流程

  1. 对照迁移指南列出目标版本中行为改变的内部函数。
  2. 检查调用点是否仍依赖返回 false 或告警。
  3. 用 try/catch 承接新的异常路径,或提前做入参校验。

代码或图示

// 以类型不匹配场景为例:8.x 下类型错误走 TypeError 路径
function acceptInt(int $value): int {
    return $value;
}

try {
    acceptInt('not-a-number');
} catch (TypeError $e) {
    echo 'TypeError: ', $e->getMessage(), PHP_EOL;
}

// 旧式返回 false 判断仍适用于设计上返回 false 的函数,不要一概替换
$str = 'abc';
echo strpos($str, 'b') !== false ? 'found' : 'missing', PHP_EOL;

常见误区

  • 以为所有内部函数都已改为抛异常:迁移是渐进的,部分函数仍保留告警/返回 false 的旧行为。
  • 把旧式 === false 防护全部删掉:是否改异常取决于具体函数的版本行为,需逐个核对。

追问

  • 如何核对某个内部函数在目标版本的行为?答:查官方手册该函数的参数类型与返回值说明,并用本机 php -r 传入非法值观察是告警、返回 false 还是抛异常。
  • 弱类型模式会改变异常行为吗?答:类型转换与校验规则受 strict_types 与类型声明影响;严格模式下类型不匹配更易直接抛 TypeError,实测为准。

04.5.2.10-005 set_error_handler 的回调签名与返回值约定是什么?

一句话结论

set_error_handler 注册的回调接收错误级别、错误消息、文件名、行号、上下文等参数;回调返回 false 表示把错误交还给引擎默认处理,返回 true(或不返回)表示已接管,不再走默认错误流程。

概念解释

用户态错误处理器接管 E_WARNING、E_NOTICE、E_USER_*、E_DEPRECATED 等可捕获级别;核心致命错误不走用户处理器。回调内通常记录日志并按级别决定是否转换为异常。

原理流程

  1. 调用 set_error_handler(回调, 级别掩码) 注册处理器。
  2. 触发对应级别错误时引擎把参数传入回调。
  3. 回调返回 false 放行给默认流程;返回真值则视为已处理。

代码或图示

set_error_handler(function (int $errno, string $errstr, string $errfile, int $errline): bool {
    error_log(sprintf('[%d] %s at %s:%d', $errno, $errstr, $errfile, $errline));
    // 返回 false 可放行给默认错误处理;此处接管则返回 true
    return true;
});

trigger_error('custom notice', E_USER_NOTICE);
restore_error_handler();

常见误区

  • 以为处理器能拦截 E_ERROR 级别的致命错误:核心致命错误不经过用户态错误处理器。
  • 回调永远返回 false:错误会继续走默认流程并可能按 display_errors 输出,接管意图落空。

追问

  • 第五个参数 errcontext 还有用吗?答:历史上携带符号表上下文;当前版本是否填充、内容形态以官方文档与本机实测为准(待确认)。
  • 处理器如何恢复默认?答:restore_error_handler() 弹出最近注册的用户处理器;多层注册时注意注册与恢复配对。

04.5.2.10-006 错误级别常量有哪些?如何按掩码过滤?

一句话结论

本机实测核心级别包括 E_ERROR、E_WARNING、E_NOTICE、E_PARSE、E_CORE_ERROR、E_CORE_WARNING、E_COMPILE_ERROR、E_COMPILE_WARNING、E_USER_ERROR、E_USER_WARNING、E_USER_NOTICE、E_STRICT、E_RECOVERABLE_ERROR、E_DEPRECATED、E_USER_DEPRECATED、E_ALL;处理器与 error_reporting 用位掩码匹配级别。

概念解释

级别分核心错误、编译错误、用户触发错误、废弃提示等组;E_ALL 是除 E_STRICT 历史差异外的全集(具体包含关系以版本为准)。注册处理器时第二个参数声明接管哪些级别,未命中的级别仍走默认流程。

原理流程

  1. 明确需要接管的级别组(如 warning、notice、deprecation)。
  2. 用按位或组合常量传入 set_error_handler。
  3. 回调内按 $errno 判断级别,分别记录或转换。

代码或图示

$levels = E_WARNING | E_NOTICE | E_USER_DEPRECATED | E_DEPRECATED;

set_error_handler(function (int $errno, string $errstr): bool {
    $label = match (true) {
        $errno === E_WARNING => 'warning',
        $errno === E_NOTICE => 'notice',
        $errno === E_DEPRECATED || $errno === E_USER_DEPRECATED => 'deprecation',
        default => 'other',
    };
    error_log("[$label] $errstr");
    return true;
}, $levels);

trigger_error('deprecation sample', E_USER_DEPRECATED);
restore_error_handler();

常见误区

  • 把级别当成布尔开关:级别是位掩码,组合用 |,判断用 &。
  • 以为 E_ALL 在所有版本包含所有位:历史上 E_STRICT 与 E_ALL 的包含关系有变化,以本机常量值为准。

追问

  • 如何列出本机全部级别常量?答:get_defined_constants(true)['Core'] 中过滤 E_ 前缀,本机探针已验证该方式可用。
  • E_RECOVERABLE_ERROR 语义是什么?答:可恢复的致命错误,通常发生在类型不严格匹配等场景;能否被处理器接管以当前版本行为为准(待确认)。

04.5.2.10-007 哪些错误可被用户处理器捕获,哪些直接致命?

一句话结论

warning、notice、user 系列、deprecation 等可捕获级别经过 set_error_handler;解析错误、核心致命错误、内存耗尽、类型/参数绑定期抛出的 Error 不经过错误处理器,分别走异常或终止流程。

概念解释

错误通道有三条:用户态错误处理器(告警类)、异常/Error 传播(可 throw 的对象)、脚本终止(致命错误与 shutdown 兜底)。判断一个问题走哪条通道,要看触发点在引擎内部的上报方式。

原理流程

  1. 触发点是告警级别:进入用户错误处理器或默认告警流程。
  2. 触发点是可抛出对象:沿调用栈进入 catch 链。
  3. 触发点是核心致命错误:脚本终止,进入 shutdown 函数兜底。

代码或图示

// 告警类:可被 set_error_handler 接管
set_error_handler(function (int $errno, string $errstr): bool {
    echo 'handled warning: ', $errstr, PHP_EOL;
    return true;
});

// 异常类:走 catch 链
try {
    throw new RuntimeException('boom');
} catch (RuntimeException $e) {
    echo 'caught: ', $e->getMessage(), PHP_EOL;
}

restore_error_handler();

常见误区

  • 以为注册错误处理器就能拦住所有问题:致命错误与绑定期 Error 不走该通道。
  • 把告警转异常后忘记恢复:处理器内抛异常会中断当前流程,注意作用域。

追问

  • E_PARSE 能被错误处理器捕获吗?答:解析错误发生在脚本编译阶段,通常以 ParseError/致命错误形式出现,不经过运行期错误处理器;具体表现以本机探针为准。
  • 致命错误后还能执行代码吗?答:可在 register_shutdown_function 注册的回调中通过 error_get_last() 取最后错误,但不能恢复执行上下文。

04.5.2.10-008 错误转异常(ErrorException)的边界是什么?

一句话结论

在错误处理器里把可捕获告警包装成 ErrorException 抛出,可以统一走异常链路;但只能覆盖用户处理器接管的级别,且要避免把 notice 级噪音全部升级为异常导致流程中断。

概念解释

ErrorException 是对错误级别、消息、文件、行号的异常包装。转换策略通常按级别区分:warning 以上转异常,notice/deprecation 只记录。转换后异常携带原始错误码,便于日志区分来源。

原理流程

  1. 注册错误处理器,按级别筛选需要转换的错误。
  2. 把 $errno、$errstr、$errfile、$errline 包装为 ErrorException。
  3. 抛出后由上层 catch 统一处理;低级别错误只记日志不抛。

代码或图示

set_error_handler(function (int $errno, string $errstr, string $errfile, int $errline): bool {
    if (in_array($errno, [E_WARNING, E_USER_ERROR, E_RECOVERABLE_ERROR], true)) {
        throw new ErrorException($errstr, 0, $errno, $errfile, $errline);
    }
    error_log("notice: $errstr");
    return true;
});

try {
    trigger_error('user warning sample', E_USER_WARNING);
} catch (ErrorException $e) {
    echo 'converted: ', $e->getMessage(), ' code=', $e->getCode(), PHP_EOL;
}

restore_error_handler();

常见误区

  • 把所有级别都转异常:大量 notice 会让异常链路被噪音淹没。
  • 转换后不区分原始级别:ErrorException::getCode() 保存原始错误级别,日志应保留该信息。

追问

  • ErrorException 继承自哪个基类?答:继承 Exception;需要在 Throwable 体系中定位时用 instanceof 核对。
  • 错误转异常后 error_get_last() 还记录吗?答:原始告警是否写入最后错误信息,取决于处理器接管与引擎默认行为,实测为准。

04.5.2.10-009 set_exception_handler 如何处理未捕获异常?

一句话结论

set_exception_handler 注册一个回调,接收所有未被 catch 接住的异常/Error,用于统一记录日志、生成错误响应;它是进程级最后一道异常兜底,不能恢复业务执行。

概念解释

异常在调用栈中未被任何 catch 匹配时,引擎调用注册的异常处理器。Web 场景下处理器负责结构化日志与错误响应;CLI 场景下负责退出码与诊断输出。处理器内不应再假设业务上下文完整可用。

原理流程

  1. 应用启动时注册全局异常处理器。
  2. 未捕获 Throwable 向上传播到栈底。
  3. 引擎调用处理器回调;回调记录上下文并输出响应,随后脚本结束。

代码或图示

set_exception_handler(function (Throwable $e): void {
    error_log(sprintf('Uncaught %s: %s in %s:%d', get_class($e), $e->getMessage(), $e->getFile(), $e->getLine()));
    http_response_code(500);
    echo 'internal error', PHP_EOL;
});

// 模拟未捕获异常(实际项目中由框架注册处理器)
function fail(): void {
    throw new RuntimeException('unrecoverable');
}

常见误区

  • 以为异常处理器能把异常“吞掉”后继续执行:兜底结束后进程终止,业务流程不会回到抛出点。
  • 在处理器里再次抛异常:二次异常行为不可靠,应只做记录与响应输出。

追问

  • 处理器恢复默认用什么函数?答:restore_exception_handler() 恢复到上一层默认处理器;框架通常在启动时注册,不要在业务代码中随意覆盖。
  • Error 也会进这个处理器吗?答:会,未捕获的 Error 同样实现 Throwable,由异常处理器兜底。

04.5.2.10-010 shutdown 函数与致命错误兜底是什么关系?

一句话结论

register_shutdown_function 注册的回调在脚本正常结束或致命错误终止时都会执行;配合 error_get_last() 可以在致命错误后做最后记录,但无法恢复执行。

概念解释

shutdown 回调是进程退出前的钩子:请求结束、exit、致命错误终止都会触发。致命错误发生后,异常处理器不一定被调用,但 shutdown 回调仍会运行,适合做最终错误落盘与资源收尾。

原理流程

  1. 启动阶段注册 shutdown 回调。
  2. 脚本结束(正常或致命)时按注册顺序执行回调。
  3. 回调内用 error_get_last() 判断是否存在最后错误,决定记录方式。

代码或图示

register_shutdown_function(function (): void {
    $last = error_get_last();
    if ($last !== null && in_array($last['type'], [E_ERROR, E_COMPILE_ERROR, E_CORE_ERROR], true)) {
        error_log(sprintf('fatal: %s at %s:%d', $last['message'], $last['file'], $last['line']));
    }
});

echo 'request finishing', PHP_EOL;

常见误区

  • 在 shutdown 回调里重新执行业务逻辑:上下文已被销毁,只能做记录、响应输出与轻量收尾。
  • 以为所有错误都会出现在 error_get_last():只有最后一次错误会被保存,被处理器接管的告警不一定写入。

追问

  • shutdown 回调执行顺序如何?答:按注册顺序执行;多层框架注册时注意顺序与依赖。
  • 常驻进程中 shutdown 钩子何时触发?答:进程退出时触发;单个请求结束不必然触发 shutdown,行为与 SAPI 和运行时有关(待确认)。

04.5.2.10-011 异常链 getPrevious 如何使用?

一句话结论

异常构造函数第三参数可传入前一个 Throwable,形成异常链;getPrevious() 沿链回溯,用于包装底层异常同时保留原始堆栈。

概念解释

上层服务把底层异常(如数据库异常)包装成领域异常对外抛出,调用方看到领域类型,日志中仍可沿链路找到根因。异常链不改变匹配类型:catch 只匹配当前异常类型,需要时主动回溯 getPrevious()。

原理流程

  1. 底层抛出原始异常。
  2. 上层 catch 后构造领域异常,把原始异常作为 $previous 传入。
  3. 记录日志时遍历 getPrevious() 输出完整链路。

代码或图示

class RepositoryException extends RuntimeException {}

function save(): void {
    try {
        throw new PDOException('connection refused');
    } catch (PDOException $e) {
        throw new RepositoryException('save failed', 0, $e);
    }
}

try {
    save();
} catch (RepositoryException $e) {
    echo $e->getMessage(), PHP_EOL;
    $prev = $e->getPrevious();
    while ($prev !== null) {
        echo '  caused by: ', get_class($prev), ' ', $prev->getMessage(), PHP_EOL;
        $prev = $prev->getPrevious();
    }
}

常见误区

  • 包装异常时不传原始异常:根因堆栈丢失,线上难以定位。
  • 以为 catch 会自动匹配链上的异常类型:catch 只检查当前对象类型,链上异常需手动回溯。

追问

  • 异常码如何在链上保留?答:领域异常可定义自己的错误码;原始异常信息通过链访问,不要把底层错误码直接暴露给调用方。
  • 循环引用可能出现在异常链吗?答:构造时单向传入 previous;读取方回溯应防止意外环结构,正常框架代码不会构造环。

04.5.2.10-012 finally 块的执行时机与覆盖规则是什么?

一句话结论

finally 在 try/catch 结束后无论是否抛异常都执行;即使 try 或 catch 中 return 或 throw,finally 仍先执行再完成返回或抛出。

概念解释

finally 用于资源释放(关闭句柄、回滚标记、释放锁),不依赖异常是否被捕获。需要注意 finally 中再次抛出异常会覆盖原异常;finally 中的 return 会丢弃待抛出的异常。

原理流程

  1. 执行 try 块。
  2. 无异常则走 finally;有异常则匹配 catch,再走 finally。
  3. finally 执行完毕后,完成原定的返回或异常传播。

代码或图示

function readLines(string $path): array {
    $handle = fopen($path, 'r');
    try {
        if ($handle === false) {
            throw new RuntimeException('open failed');
        }
        $lines = [];
        while (($line = fgets($handle)) !== false) {
            $lines[] = trim($line);
        }
        return $lines;
    } finally {
        if (is_resource($handle)) {
            fclose($handle);
        }
    }
}

try {
    readLines('missing.txt');
} catch (RuntimeException $e) {
    echo 'caught: ', $e->getMessage(), PHP_EOL;
}

常见误区

  • 在 finally 里写业务返回逻辑:finally 的 return 会抑制待传播异常,属于隐蔽陷阱。
  • 以为 catch 之后就不会执行 finally:finally 在 catch 结束后仍然执行。

追问

  • finally 中抛异常会怎样?答:新抛出的异常会替代原待传播异常;原异常是否可访问取决于实现,应避免在 finally 抛错。
  • 资源释放有比 finally 更好的方式吗?答:实现可关闭接口配合框架作用域管理;finally 是语言层兜底手段。

04.5.2.10-013 多异常 catch(联合 catch)如何使用与选型?

一句话结论

catch (AException | BException $e) 可在同一分支处理多个平级异常类型;不同类型需要不同处理逻辑时,应分开写 catch 分支,按具体类型从上到下匹配。

概念解释

联合 catch 适合多个类型走同一兜底流程(如记录日志后返回默认值)。异常类型匹配从左到右、从上到下;子类必须写在父类之前,否则被父类分支提前捕获。非捕获形式(省略变量名)与联合类型可组合使用。

原理流程

  1. 列出同一流程要处理的异常类型。
  2. 平级类型合并到一个联合 catch;需要差异化处理的类型单独分支。
  3. 分支顺序从具体到宽泛。

代码或图示

function load(int $id): array {
    if ($id <= 0) {
        throw new InvalidArgumentException('bad id');
    }
    if ($id > 100) {
        throw new OutOfRangeException('id too large');
    }
    return ['id' => $id];
}

try {
    load(-1);
} catch (InvalidArgumentException | OutOfRangeException $e) {
    echo 'param issue: ', get_class($e), ' ', $e->getMessage(), PHP_EOL;
} catch (RuntimeException $e) {
    echo 'runtime issue', PHP_EOL;
}

常见误区

  • 把子类写在父类联合分支之后:父类分支先命中,子类分支永远执行不到。
  • 用联合 catch 掩盖类型差异:不同类型的重试、降级策略不同,应分开处理。

追问

  • 联合 catch 中的变量类型是什么?答:变量静态类型是所列类型的联合;运行时对象是实际抛出的具体子类。
  • 联合 catch 能接 Error 与 Exception 混用吗?答:可以写在同一 Throwable 体系下;但建议按 Error/Exception 语义分组处理。

04.5.2.10-014 多任务场景如何做异常聚合?

一句话结论

并行或批量处理多个子任务时,应收集每个子任务的异常,任务全部结束后统一抛出聚合异常或返回错误列表;PHP 核心没有通用的内置聚合异常类,具体实现以项目约定或第三方库为准(待确认)。

概念解释

单任务异常中断整批处理,会导致其余子任务得不到执行;聚合模式先让每个子任务隔离 try/catch,把成功结果与失败异常分别收集,最后由上层决定是抛聚合异常还是部分成功返回。语言层只提供 Throwable 与异常链,聚合容器需要自行实现。

原理流程

  1. 遍历子任务,每个任务独立 try/catch。
  2. 成功结果入结果列表,异常入错误列表并保留任务标识。
  3. 全部结束后按策略:错误为空返回结果,非空抛聚合异常或返回部分结果。

代码或图示

class AggregateException extends RuntimeException {
    /** @var Throwable[] */
    private array $errors = [];

    public function add(Throwable $e): void {
        $this->errors[] = $e;
    }

    /** @return Throwable[] */
    public function getErrors(): array {
        return $this->errors;
    }
}

function processAll(array $tasks): array {
    $results = [];
    $aggregate = new AggregateException('batch failed');
    foreach ($tasks as $key => $task) {
        try {
            $results[$key] = $task();
        } catch (Throwable $e) {
            $aggregate->add($e);
        }
    }
    if (count($aggregate->getErrors()) > 0) {
        throw $aggregate;
    }
    return $results;
}

$tasks = [
    'a' => fn() => 'ok-a',
    'b' => fn() => throw new RuntimeException('b failed'),
];

try {
    processAll($tasks);
} catch (AggregateException $e) {
    echo 'errors: ', count($e->getErrors()), PHP_EOL;
}

常见误区

  • 子任务异常直接向外抛:后续任务不再执行,批处理失败面被放大。
  • 聚合异常不带任务标识:日志无法定位是哪个子任务失败。

追问

  • 聚合异常与异常链如何配合?答:聚合异常持有异常数组;getPrevious() 只保存单一根因,批量场景用错误列表更直观。
  • 核心 Spl 扩展有聚合异常可用吗?答:以本机 get_declared_classes() 核对;未确认前不要引用具体内置类名(待确认)。

04.5.2.10-015 SensitiveParameter 在错误处理链路中起什么作用?

一句话结论

#[SensitiveParameter] 标记的参数在异常回溯中被脱敏,避免密码、密钥等随栈轨迹写入日志;其标注方式与回溯展示细节已在 04.5.2.3 展开,本页只从错误处理链路角度说明接入位置。

概念解释

异常生成回溯时,引擎按参数标记决定是否替换参数值;错误处理器、异常处理器、shutdown 日志在序列化回溯前,敏感值已被处理。接入要点是:凭证类形参必须标注,日志输出回溯时不要重新拼接原始参数。

原理流程

  1. 形参声明处加 #[SensitiveParameter]。
  2. 异常抛出生成回溯帧时,标记参数值被替换。
  3. 日志链路读取回溯信息,落盘内容不含明文敏感值。

代码或图示

function login(string $user, #[SensitiveParameter] string $password): void {
    if ($password === '') {
        throw new InvalidArgumentException('empty password');
    }
}

try {
    login('ann', 'secret-value');
} catch (InvalidArgumentException $e) {
    foreach ($e->getTrace() as $frame) {
        echo ($frame['function'] ?? '?'), PHP_EOL;
    }
}

常见误区

  • 以为标注后业务代码内参数也被隐藏:只影响回溯展示,函数体内仍可读取明文参数。
  • 日志自行拼接 func_get_args():绕过回溯脱敏,可能重新泄露敏感值。

追问

  • 脱敏后回溯里参数显示为什么?答:以当前版本回溯格式为准(通常替换为固定占位),可用本机抛异常后打印 getTraceAsString() 实测。
  • 除形参外还有哪些泄露面?答:异常消息、上下文数组、会话与日志缓存;敏感信息管理见 04.5.2.3 对应题目。

04.5.2.10-016 回溯信息如何获取,生产环境暴露边界是什么?

一句话结论

异常对象通过 getTrace() 取结构化回溯数组、getTraceAsString() 取文本回溯;生产环境只应把回溯写入受控日志,响应给客户端的错误信息不得包含文件路径、行号与内部堆栈。

概念解释

回溯包含调用链、类名、方法名、文件名、行号与参数快照,对调试很有价值,但也泄露内部结构。边界原则:开发环境可完整展示,生产环境对外返回通用错误提示,详细回溯进日志并按权限访问。

原理流程

  1. 捕获异常后取 getTrace()/getTraceAsString()。
  2. 日志通道记录完整回溯与异常上下文。
  3. 响应层只返回错误码与通用消息,不附带堆栈。

代码或图示

function report(Throwable $e): array {
    error_log($e->getTraceAsString());
    return [
        'code' => $e->getCode() !== 0 ? $e->getCode() : 500,
        'message' => 'internal error',
    ];
}

try {
    throw new RuntimeException('demo');
} catch (RuntimeException $e) {
    $payload = report($e);
    echo json_encode($payload), PHP_EOL;
}

常见误区

  • 生产环境开启 display_errors 直接输出回溯:内部路径与代码结构对外暴露。
  • 日志中保存完整参数快照:可能包含敏感与大体积数据,应按字段过滤。

追问

  • getTrace() 数组每帧包含哪些键?答:常见键含 function、class、type、file、line、args;具体键集以本机探针输出为准。
  • 回溯性能有成本吗?答:生成回溯涉及栈遍历;高频场景下按需记录,避免在热路径反复序列化完整堆栈。

04.5.2.10-017 deprecation 告警如何收集与统计?

一句话结论

E_DEPRECATED 与 E_USER_DEPRECATED 走错误处理器通道;升级前应在测试环境收集全部废弃告警,按调用位置归类统计,作为迁移清单的输入,而不是在生产环境静默忽略。

概念解释

废弃告警是版本升级的预警信号:当前版本仍可用,后续版本可能移除。收集方式有两种:错误处理器按级别捕获后写入专门日志,或框架/测试套件统计 deprecation 条目。统计维度按触发文件、调用栈、废弃 API 分组。

原理流程

  1. 注册错误处理器,过滤 deprecation 级别。
  2. 记录消息、文件、行号与调用栈摘要。
  3. 测试跑完后聚合去重,形成待迁移清单。

代码或图示

$deprecations = [];

set_error_handler(function (int $errno, string $errstr, string $errfile, int $errline) use (&$deprecations): bool {
    if ($errno === E_DEPRECATED || $errno === E_USER_DEPRECATED) {
        $deprecations[] = ['message' => $errstr, 'file' => $errfile, 'line' => $errline];
    }
    return true;
});

trigger_error('sample deprecated call', E_USER_DEPRECATED);
restore_error_handler();

echo 'deprecations: ', count($deprecations), PHP_EOL;

常见误区

  • 生产环境用 error_reporting 关掉 deprecation:告警被隐藏,升级风险不可见。
  • 只统计消息不去重:同一废弃 API 在热路径反复触发,按文件+行号+消息聚类才有意义。

追问

  • 如何区分核心废弃与用户态废弃?答:E_DEPRECATED 来自引擎/内部函数,E_USER_DEPRECATED 来自代码或库主动 trigger_error。
  • 测试套件能把 deprecation 变成失败吗?答:可在处理器中对新增废弃计数,超过阈值即阻断 CI;具体实现按项目测试框架约定(待确认)。

04.5.2.10-018 哪些错误属于不可捕获的致命错误?

一句话结论

内存耗尽、段错误、核心启动失败、部分内部断言错误等在引擎层终止进程,不经过用户错误处理器与异常 catch;业务代码能做的只是在 shutdown 钩子中记录最后状态。

概念解释

可捕获范围以“错误是否以 Throwable 对象或用户告警形式上报”为界:绑定期 TypeError、调用期 ValueError 等是 Throwable;核心资源耗尽、内存破坏、扩展内部致命错误直接终止进程。识别不可捕获错误有助于设定降级预期。

原理流程

  1. 判断问题是否生成 Throwable 对象:是则进入 catch 链。
  2. 判断是否为可捕获告警级别:是则进入错误处理器。
  3. 其余核心致命错误直接终止,shutdown 钩子做收尾记录。

代码或图示

register_shutdown_function(function (): void {
    $last = error_get_last();
    if ($last !== null) {
        error_log('last error: ' . $last['message'] . ' @ ' . $last['file'] . ':' . $last['line']);
    }
});

// 可捕获示例:Throwable 路径
try {
    throw new ValueError('bad value');
} catch (ValueError $e) {
    echo 'catchable: ', $e->getMessage(), PHP_EOL;
}

常见误区

  • 以为注册异常处理器就能拦住内存耗尽:核心致命错误不生成 Throwable 对象。
  • 在业务代码里假设所有失败都可恢复:关键流程需要外部监控与进程重启兜底。

追问

  • 内存耗尽在什么阶段发生?答:分配请求无法满足时引擎终止;memory_limit 调整与代码内存优化是主要应对手段。
  • 扩展导致的段错误如何定位?答:需要 core dump、扩展符号表与日志;本机环境不具备该排查条件,标注待确认并由生产环境分析。

04.5.2.10-019 异常处理在常驻进程与 FPM 中有什么差异?

一句话结论

FPM 每个请求独立进程上下文,未捕获异常随请求结束回收;常驻进程中 worker 循环复用,异常必须在请求边界内被捕获处理,未捕获异常可能拖垮 worker 或污染下一个请求的状态。

概念解释

常驻模式下进程不退出,异常抛出后若泄漏到请求循环外,会中断循环、留下未释放资源或残留静态状态。处理原则:每个请求入口包一层兜底 catch,记录异常并清理请求级状态,再把 worker 交回循环。

原理流程

  1. worker 进入请求循环。
  2. 每个请求在入口处包裹全局兜底处理。
  3. 请求结束后清理请求级状态;异常不允许穿过循环边界。

代码或图示

function handleRequest(callable $action): void {
    try {
        $action();
    } catch (Throwable $e) {
        error_log('request failed: ' . $e->getMessage());
        // 清理请求级状态:重置上下文、释放连接引用等
    } finally {
        // 请求间重置逻辑放这里
    }
}

$workerLoop = function (array $actions): void {
    foreach ($actions as $action) {
        handleRequest($action);
    }
};

$workerLoop([
    function () { echo 'task-1', PHP_EOL; },
    fn() => throw new RuntimeException('task-2 failed'),
]);

常见误区

  • 把 FPM 的“异常即进程结束”假设带到常驻模式:常驻进程不退出,残留状态会影响后续请求。
  • 兜底 catch 后不清理状态:单例、静态缓存、连接残留可能跨请求泄露。

追问

  • 常驻模式下 worker 什么情况下应主动重启?答:出现不可恢复错误、资源泄漏迹象或达到处理任务数上限时,由运行时回收 worker;具体机制见 04.5.2.14。
  • 异常回溯在常驻模式有额外成本吗?答:长生命周期进程中栈更深、对象更多,回溯序列化体积更大,日志应做字段裁剪。

04.5.2.10-020 错误处理体系 8.0→8.5 演进有哪些小结与待确认项?

一句话结论

演进主线是错误通道统一到 Throwable、内部函数校验从告警向 Error/Exception 迁移、敏感参数回溯脱敏;版本敏感的具体迁移清单、级别行为与扩展侧致命错误表现需对照官方迁移指南并以本机探针复核。

概念解释

面试中应能画出三条通道(异常链、错误处理器、shutdown 兜底)与 Error/Exception 分层;8.0 之后的增量重点是类型校验强化与安全脱敏。未在本机验证的行为(内部函数逐项迁移、扩展致命错误、第三方框架异常封装)统一标注待确认。

原理流程

  1. 按 Throwable 分层梳理可捕获类型。
  2. 按通道梳理处理器、兜底与回溯边界。
  3. 版本差异用迁移指南加本机探针核对,不凭记忆下结论。

代码或图示

// 本机错误处理能力探针
$checks = [
    'set_error_handler' => function_exists('set_error_handler'),
    'set_exception_handler' => function_exists('set_exception_handler'),
    'register_shutdown_function' => function_exists('register_shutdown_function'),
    'error_get_last' => function_exists('error_get_last'),
    'ErrorException' => class_exists(ErrorException::class),
];

foreach ($checks as $name => $ok) {
    echo $name, ': ', $ok ? 'yes' : 'no', PHP_EOL;
}

常见误区

  • 把 7.x 时代的告警处理习惯直接沿用到 8.x:类型校验行为已明显收紧,旧容错路径需要复核。
  • 混淆语言层异常体系与框架层异常封装:框架异常类继承内置基类,分层关系以 instanceof 实测为准。

追问

  • 如何核对某个版本新增/收紧的错误行为?答:查阅对应版本迁移指南的 "Backward incompatible changes" 章节,再用 php -r 构造非法入参观察实际通道与异常类型。
  • 本页与 04.5.1 的基础异常题如何分界?答:基础异常概念、try/catch 语法见 04.5.1;本页聚焦 8.0 后的分层演进、处理器落地与常驻环境差异。