You need to enable JavaScript to run this app. Laravel 中使用 GuzzleHttp 遇到429错误时如何获取HTTP状态码
优惠活动
大模型
产品
解决方案
定价
更多

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ı

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 20:54:03