Guzzle遇302重定向后未保持HEAD请求,如何解决?
问题:Guzzle发送HEAD请求遇302重定向自动转为GET,导致下载大文件浪费资源
我需要对文件下载URL发送HEAD请求,在不下载整个文件的前提下检查响应头里的ETag,使用了以下代码:
$headers = $this->guzzle->head($url, ['debug' => true])->getHeaders();
但实际运行时发现它会下载整个文件。开启debug选项后看到:原URL的HEAD请求返回302重定向到Amazon S3,但Guzzle跟进重定向时自动把请求改成了GET:
> HEAD /my-url HTTP/1.1 Host: dl.somecdn.com < HTTP/1.1 302 Found < Content-Length: 0 < Location: https://2-web-shpcd1.dl.somecdn.com/d786/200050/mf/2508250/13372192.pdf > GET /d786/200050/mf/2508250/13372192.pdf User-Agent: Laravel/#unknown GuzzleHttp/6.5.5 curl/7.74.0 PHP/8.1.15 < HTTP/1.1 200 OK < Content-Type: application/octet-stream < Content-Length: 516612308 < ETag: "8f7414fc764ae7ebb668dc8836c9539f-5" < Server: AmazonS3 < X-Cache: Hit from cloudfront < Via: 1.1 4eb35caa679bb95c591a03f41b151b8c.cloudfront.net (CloudFront) < X-Amz-Cf-Pop: YTO50-P1 < X-Amz-Cf-Id: LaI4vdjpcwfhhqb3OqTqt23Ooc4fLgb_PQJYnTlTPJQNvA2mGw_nww==
这种GET请求会返回完整文件,对多GB级别的文件来说资源浪费严重。之前找到过2018年类似的Guzzle问题,但针对的是301重定向,想知道302重定向有没有可行的解决办法?
解决办法
针对Guzzle在302重定向时自动将HEAD转为GET的问题,可采用以下几种方案:
- 手动处理重定向:关闭Guzzle的自动重定向功能,自行解析302响应的
Location头,再对重定向目标URL发送HEAD请求。代码示例:
// 关闭自动重定向 $initialResponse = $this->guzzle->head($url, [ 'debug' => true, 'allow_redirects' => false ]); // 处理302重定向 if ($initialResponse->getStatusCode() === 302) { $redirectUrl = $initialResponse->getHeaderLine('Location'); // 对重定向后的URL发起HEAD请求 $finalResponse = $this->guzzle->head($redirectUrl, ['debug' => true]); $headers = $finalResponse->getHeaders(); $etag = $headers['ETag'][0] ?? null; }
自定义重定向中间件:如果需要处理多层重定向场景,可以自定义Guzzle的重定向中间件,强制重定向时保持HEAD请求方法。核心思路:
- 复制Guzzle默认的
RedirectMiddleware代码 - 修改其中的请求方法判断逻辑,当原请求为HEAD时,重定向请求仍使用HEAD,而非转为GET
- 将自定义中间件替换Guzzle默认的重定向中间件
- 复制Guzzle默认的
升级Guzzle版本:检查Guzzle的新版本是否修复了该问题,部分较新版本可能优化了302重定向时HEAD请求的处理逻辑(需自行验证)
内容的提问来源于stack exchange,提问作者Chris White
相关产品推荐
相关产品推荐

