Laravel 8+ 推荐使用内置 Http facade 调用外部 API，无需额外安装包，语法简洁且基于 Guzzle；需注意引入命名空间、版本要求、SSL 证书配置、命名 client 复用及异步调用应通过队列实现。
用 Http facade 调用外部 API 最省事
Laravel 8+ 自带的 Http facade 是调用第三方 API 的首选，不用装额外包，语法干净，错误处理也直观。它底层用的是 Guzzle，但屏蔽了大部分配置细节，适合大多数场景。
常见错误现象：Class 'Http' not found——忘了在文件顶部加 use Illuminate\Support\Facades\Http;；或者 Laravel 版本低于 7.0（该 facade 从 7.0 引入）。
实操建议：
- 在控制器或服务类里直接用
Http::get('https://api.example.com/users') - 带参数时用数组传参：
Http::get('https://api.example.com/search', ['q' => $keyword]) - POST 提交 JSON 数据：
Http::post('https://api.example.com/webhook', ['event' => 'order_created']) - 超时和重试要显式设置：
Http::timeout(5)->retry(2, 100)->get(...)，否则默认不重试、超时是无限的
遇到 cURL error 60 或 SSL 验证失败怎么办
本地开发（尤其是 Windows 或 Homestead）调用 HTTPS 接口时，常报 cURL error 60: SSL certificate problem。这不是 Laravel 的 bug，而是 Guzzle 默认校验 CA 证书，而你的环境缺证书或路径不对。
不要直接关 SSL 验证（->withOptions(['verify' => false])），那会埋安全漏洞。优先走修复路径：
- 确认
curl.cainfo在php.ini中已指向有效的 CA bundle（如C:\wamp64\bin\php\php8.1.12\cacert.pem） - Mac M1 用户常见问题是 Homebrew 安装的 PHP 没配对 OpenSSL，执行
brew install ca-certificates && brew link --force ca-certificates - 实在临时调试，只在开发环境加
->withOptions(['verify' => base_path('http/cacert.pem')])，别用false
需要复用请求头、基础 URL？写个自定义 HTTP client
多个接口共用 token、固定前缀、统一 User-Agent 时，每次都写 Http::withToken(...)->baseUrl(...) 很啰嗦，也容易漏。Laravel 支持注册命名 client，在 config/services.php 里配好，再通过 Http::client('github') 调用。
性能影响：命名 client 只是预设参数，不额外开连接，无 runtime 开销。
实操建议：
- 在
config/services.php加一段：'github' => [ 'base_uri' => 'https://api.github.com/', 'headers' => ['User-Agent' => 'MyApp/1.0'], ], - 代码中用：
Http::client('github')->get('/users/octocat') - 注意：命名 client 不支持运行时动态改
base_uri，如果域名要拼接变量（如租户子域），还是得用普通调用 +baseUrl()
异步调用不是加 async 就完事
Laravel 的 Http facade 没有原生 async 方法。所谓“异步”，实际是靠队列 + 同步 HTTP 请求实现的。直接在请求中发起耗时 API 调用（比如发短信、推送通知），会拖慢用户响应，必须剥离到 job 里。
容易踩的坑：dispatch(new CallExternalApiJob($data)) 后没检查 job 是否失败，也没设 $tries 和 $backoff，结果第三方服务抖动导致任务静默丢弃。
实操建议：
- 把外部调用逻辑封装进 job，构造函数接收必要参数（别传 request 或 session 对象）
- 在 job 的
handle()里用Http::timeout(10)->retry(3, 1000)->post(...) - 捕获
GuzzleHttp\Exception\RequestException并记录日志，必要时触发告警 - 避免在 job 里做重试兜底逻辑——交给 Laravel 的
$tries和队列重试机制更可靠
真正麻烦的从来不是怎么发请求，而是怎么应对对方接口不稳定、字段随时变、文档永远滞后。留好日志、设好熔断、把 schema 校验当第一道防线，比选哪个 HTTP 客户端重要得多。
