Laravel 中使用 GuzzleHttp 遇到429错误时如何获取HTTP状态码
问题成因
该场景下触发异常中断、无法执行原有状态码获取逻辑的核心原因,是Guzzle默认开启了http_errors配置项:
- 默认配置下,当接口返回的HTTP状态码属于4xx(客户端错误)、5xx(服务端错误)区间时,Guzzle不会将响应对象传入业务代码的正常返回流程,而是直接抛出对应异常
- 对应4xx状态码会抛出
GuzzleHttp\Exception\ClientException,也就是本次429触发的异常,导致原本写的return $response->getStatusCode();逻辑完全没有执行入口
实现方案
需求为不进入异常流程、通过正常响应链路直接获取429对应的状态码,可通过以下两种方式实现:
- 全局关闭客户端自动抛HTTP错误的逻辑
初始化Guzzle客户端时传入http_errors => false配置,关闭默认的错误自动抛异常行为。此时无论接口返回何种状态码,Guzzle都会将原始响应对象返回给业务代码,可直接调用getStatusCode()获取状态码,全程不会触发4xx/5xx相关异常。
示例代码:$client = new \GuzzleHttp\Client([ 'http_errors' => false, ]); $response = $client->request('GET', 'https://api.envato.com/v3/market/author/sale', [ 'query' => ['code' => '你的接口请求参数'], ]); // 200、429等所有状态码均可正常获取 return $response->getStatusCode(); - 针对单个请求单独关闭自动抛异常逻辑
如果不想修改客户端的全局默认配置,可在具体发起请求的参数中单独传入http_errors => false,仅对当前请求生效,不影响其他请求的默认异常抛出行为。
示例代码:// 客户端保持默认配置(http_errors开启) $client = new \GuzzleHttp\Client(); $response = $client->request('GET', '接口请求地址', [ // 仅当前请求关闭自动抛异常 'http_errors' => false, 'query' => ['code' => '你的接口请求参数'], ]); return $response->getStatusCode();
补充兜底参考:如果保持默认配置不变,429触发的
ClientException异常本身会携带原始响应对象,也可以在异常捕获块中提取状态码,但该方式依然走了异常流程,不符合“不通过异常流程获取状态码”的需求,仅作为特殊场景的兜底方案参考:try { $response = $client->request('GET', '接口请求地址'); return $response->getStatusCode(); } catch (\GuzzleHttp\Exception\ClientException $e) { if ($e->hasResponse()) { return $e->getResponse()->getStatusCode(); } return 0; }
内容的提问来源于stack exchange,提问作者Gündoğdu Yakıcı
相关产品推荐
相关产品推荐

