Laravel Guzzle HTTP请求OpenLibrary API持续返回404但Postman正常

• 协议重定向未跟随：OpenLibrary 已全域对 http 协议请求返回301永久跳转至 https 域名。Postman 默认开启全链路重定向自动跟随，可直接跳转至目标地址获取正常响应；Laravel 内置 Http 客户端基于 Guzzle 封装，默认不开启重定向跟随，未配置跟随规则时，部分场景下服务端会直接对这类未跳转的请求返回404，而非标准301状态码。
• 默认请求头触发反爬拦截：Laravel Http 客户端默认携带 User-Agent: Laravel 这类标识，OpenLibrary 反爬规则会对非通用类请求标识做拦截，部分接口路径会直接返回404而非403状态码；Postman 会自动携带符合工具规范的请求头，不会触发这类拦截。
• 请求路径被全局规则改写：如果项目中配置了 Http 客户端全局宏、或者出站请求的代理/中间件规则，可能导致最终实际请求的路径和预期不一致，比如丢失 search.json 后缀、多了路径斜杠，自然触发404。
• 代理配置不匹配：如果开发环境配置了网络代理，Postman 会自动匹配系统代理规则完成转发；Laravel Http 客户端如果未正确读取代理配置，请求会被转发到错误节点，拿到对应节点返回的404。

• 优先将请求地址从明文 http 直接替换为 https，消除跨协议跳转的影响，这是最高概率的问题诱因。
• 为 Http 请求手动开启重定向跟随，消除跳转带来的异常：

  $response = Http::redirects()
      ->get('https://openlibrary.org/search.json', [
          'q' => 'Johngreen'
      ]);
  dd($response->body());
  

• 手动覆盖默认 User-Agent 请求头，模拟正常客户端请求规避反爬拦截：

  $response = Http::withHeaders([
      'User-Agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36'
  ])->get('https://openlibrary.org/search.json', [
      'q' => 'Johngreen'
  ]);
  dd($response->body());
  

• 请求完成后打印实际发出的完整URI，确认路径没有被全局规则改写，可通过 $response->transferStats->getUri() 获取实际请求地址。
• 仍异常时打印原始响应头和响应体，区分是服务端路由不存在的404，还是网关/反爬层拦截返回的404。

内容的提问来源于stack exchange，提问作者Junior Frogie