Guzzle 中异步请求的未捕获异常处理指南

2024-03-10 01:51:54

在 Guzzle 中巧妙处理异步请求的未捕获异常

简介

使用 Google Guzzle 框架进行异步请求处理时，您可能遇到一个棘手的问题：即使在 Promise 链的 then 方法中定义了 onrejected 处理函数，当请求失败时，仍然会抛出一个未捕获的异常。这可能是令人沮丧的，尤其是当您想要优雅地处理错误和异常时。

问题原因

Guzzle 中的 Promise 对象是一种包装器，表示异步操作的结果。当异步操作完成时，Promise 对象的状态会改变，并触发相应的回调函数。在 Promise 链中，then 方法用于为成功和失败的场景分别指定回调函数。

当请求失败时，onrejected 回调函数会被触发，您可以在其中处理错误并防止异常向上抛出。但是，在 Promise 链的末尾，如果使用 wait() 方法来阻塞等待请求完成，则即使在 onrejected 回调函数中处理了错误，仍然会抛出未捕获的异常。

解决方法

解决这个问题的方法有两种：

使用 try-catch 块捕获异常： 在 wait() 方法之后使用 try-catch 块来捕获异常。如果异常被抛出，您可以将其记录或进行其他处理。

$promise->then(
    function ($response) use (...){
        //do something
    },
    function ($exception) {
        $this->logger->error("Failed " . $exception->getMessage());
    }
);

try {
    $promise->wait(true);
} catch (Exception $exception) {
    $this->logger->error("Failed " . $exception->getMessage());
}

将 onrejected 回调函数作为第二个参数传递给 then 方法： 您可以将 onrejected 回调函数作为第二个参数传递给 then 方法，而不是使用单独的 then 方法。这样，异常会在 then 方法中被自动捕获并处理。

$promise->then(
    function ($response) use (...){
        //do something
    },
    function ($exception) {
        $this->logger->error("Failed " . $exception->getMessage());
    }
)->then(
    function ($response) use (...){
        //do something else
    }
);

最佳实践

为了避免在 Guzzle 中处理异步请求时遇到未捕获的异常，建议遵循以下最佳实践：

始终在 Promise 链的末尾使用 wait() 方法或 catch() 方法来处理异常。
如果使用 wait() 方法，请务必在之后使用 try-catch 块来捕获异常。
优先使用 then 方法将 onrejected 回调函数作为第二个参数传递。
在代码中明确记录处理异常的逻辑，以提高可读性和可维护性。

常见问题解答

为什么在 onrejected 回调函数中处理了异常后，仍然会抛出未捕获的异常？

这是因为在使用 wait() 方法阻塞等待请求完成时，异常会立即抛出，而不管 onrejected 回调函数是否处理了它。
为什么使用 try-catch 块来捕获异常？

使用 try-catch 块可以捕获并处理未捕获的异常，防止它们向上抛出并导致应用程序崩溃。
何时应该将 onrejected 回调函数作为第二个参数传递给 then 方法？

当您希望使用更简洁的语法并且不想创建单独的 then 方法来处理失败场景时，可以使用此方法。
如何记录在 Guzzle 中处理的异常？

您可以使用日志记录工具（例如 Monolog 或 PSR-3 兼容的日志记录器）来记录异常信息和堆栈跟踪。
如何提高 Guzzle 中处理异步请求的代码可读性和可维护性？

通过使用明确的命名约定、详细的注释和适当的异常处理机制，可以提高代码的可读性和可维护性。