PHP Fiber 内部异常怎样传回调用者

PHP Fiber 的内部异常不会凭空消失：调用者对一个处于挂起状态的 Fiber 调用 throw() 时，传入的 Throwable 会从当前 Fiber::suspend() 位置进入 Fiber。Fiber 内部有 try/catch 就在内部处理；没有被捕获时，异常会从调用 throw() 的位置继续抛给外层。

官方地址：https://www.php.net/manual/en/fiber.throw.php

Fiber::throw() 是从 suspend() 位置把异常送进去

Fiber 先通过 start() 运行到 Fiber::suspend()，此时调用者拿到挂起值，Fiber 的状态是 suspended。随后调用 throw()，效果相当于让挂起点收到一次异常，而不是从回调函数第一行重新执行。

getMessage()}", PHP_EOL;
    }
});

$first = $fiber->start();
echo "挂起值：{$first}", PHP_EOL;

// 只有 Fiber 处于 suspended 状态时，才能把异常送入当前挂起点。
$afterThrow = $fiber->throw(new RuntimeException('外部取消任务'));
var_dump($afterThrow); // 回调捕获异常后返回 null，Fiber 已经结束
var_dump($fiber->isTerminated());

上例的关键不是输出文字，而是调用关系：start() 建立挂起点，throw() 再把异常交给这个挂起点。因为 catch 在 Fiber 内部，异常不会直接跳到调用者；回调执行完后，throw() 得到的是 Fiber 后续运行的返回值，未产生下一次 suspend() 时通常是 null。

内部 catch 和调用者 catch 处理的是两条不同边界

如果 Fiber 内部没有捕获注入的异常，它会沿 Fiber 的执行边界退出，并在调用 $fiber->throw() 的位置抛出。调用者应把这次恢复动作包在 try/catch 中，而不是只检查 isTerminated()。

start();

try {
    // 这里是调用者的异常边界，负责记录、取消或转换错误。
    $fiber->throw(new RuntimeException('调度器要求继续执行'));
} catch (Throwable $exception) {
    echo "调用者接住：{$exception->getMessage()}", PHP_EOL;
}

// 无论是正常 return 还是未捕获异常，Fiber 都已经终止。
var_dump($fiber->isTerminated());

这里不要把“已经终止”理解成“执行成功”。isTerminated() 只回答 Fiber 是否已经结束，结束原因可能是回调正常返回，也可能是异常未捕获。对异常路径，应保存异常对象或错误上下文；对成功路径，才继续读取返回值。

用终止状态决定能不能读取 getReturn()

getReturn() 只适合“回调已经正常返回”的 Fiber。官方手册明确说明：Fiber 尚未启动、尚未终止，或者因为异常退出时，调用 getReturn() 都会抛出 FiberError。因此，业务代码最好先在外层区分成功与失败，而不是把所有终止状态都当作有返回值。

isSuspended()) {
            $fiber->resume();
        }

        // 终止只是状态；getReturn() 仍需处在正常返回路径。
        if ($fiber->isTerminated()) {
            return $fiber->getReturn();
        }
    } catch (Throwable $exception) {
        // 失败路径返回一个明确的领域异常，避免误读 FiberError。
        throw new RuntimeException('Fiber 未正常完成', 0, $exception);
    }

    throw new LogicException('Fiber 仍未完成，不能读取返回值');
}

这个辅助函数只展示判断顺序：先处理可恢复的 suspended 状态，再把正常完成与异常完成分开。实际调度器还可以保存每个 Fiber 的状态、异常和取消原因，但不要用一个布尔值把“完成”和“成功”混为一谈。

最容易踩到的三个 Fiber 异常误区

• 在非 suspended 状态调用 throw()：官方 API 要求当前必须存在挂起点，否则会得到 FiberError；调用前先判断状态。
• 只看 isTerminated()：异常终止也会返回真，成功与否要看是否进入了正常返回路径。
• 异常后继续调用 getReturn()：异常退出没有可读取的返回值，应保留原始 Throwable，必要时再包装成领域错误。

常见问题

Fiber::throw() 和普通的 throw 有什么区别？

普通 throw 在当前调用栈中抛出异常；Fiber::throw() 是调用者把异常送到另一个已暂停 Fiber 的 Fiber::suspend() 位置，之后仍按 Fiber 内部的 catch 规则传播。

Fiber 内部 catch 住异常后，调用者还能知道发生过异常吗？

如果内部 catch 完全处理并正常结束，调用者只会看到后续返回值或终止状态；需要保留失败原因时，应在 Fiber 内部记录、返回结构化结果，或重新抛给调用者。

异常结束后调用 isTerminated() 会是什么结果？

结果为真，因为 Fiber 已经结束；但这不等于有返回值，异常路径调用 getReturn() 仍会失败。