laravel 8+ 推荐使用内置 http 门面发 get 请求，需引入 use illuminate\support\facades\http;，url 必须带协议，超时建议显式设置，4xx/5xx 默认不抛异常需调用 throw() 或检查 failed()。
用 Http 门面发 GET 请求最直接
Laravel 8+ 内置的 Http 门面是获取远程 API 数据的首选，不用装额外包（guzzlehttp/guzzle 已作为底层依赖自动包含）。直接调用 Http::get() 即可，返回的是 Illuminate\Http\Client\Response 实例。
常见错误：没加 use Illuminate\Support\Facades\Http; 就调用 Http::get()，报 Class 'Http' not found。
- 必须在文件顶部引入：
use Illuminate\Support\Facades\Http; - URL 必须带协议（
https://或http://），写成/api/users会报错 - 默认不自动抛异常，4xx/5xx 响应仍返回 Response 对象，需手动调用
throw()或检查$response->failed() - 超时默认 30 秒，生产环境建议显式设短些：
Http::timeout(5)->get(...)
示例：
use Illuminate\Support\Facades\Http;
$response = Http::timeout(5)->get('https://jsonplaceholder.typicode.com/posts/1');
$data = $response->json(); // 自动 json_decode(true)
带 Token 或 Header 的请求怎么写
多数 API 要求认证头（如 Bearer Token），Http 提供链式方法设置，比拼接数组更清晰。
容易踩的坑：Token 字符串里混入空格或换行（尤其从配置读取时），导致 401；或者把 Authorization 写成 authorization（大小写敏感）。
- Bearer Token：
Http::withToken(config('services.api.token')) - 自定义 Header：
Http::withHeaders(['X-Api-Version' => 'v2']) - 同时用多个头，链式调用即可，顺序无关
- 如果 Token 来自用户输入（如前端传来的），务必先
trim()并校验格式，避免静默失败
示例：
$response = Http::withToken(trim(env('API_TOKEN')))
->withHeaders(['Accept' => 'application/json'])
->get('https://api.example.com/data');
POST 提交 JSON 数据要注意什么
Http::post() 默认以 application/json 发送，但前提是传入的是数组或对象——若传字符串（比如已 json_encode 过），会变成 text/plain，后端可能解析失败。
典型现象：API 返回 400 或空响应，抓包发现 Content-Type 是 text/plain。
- 正确做法：直接传关联数组，
Http自动处理序列化和 header 设置 - 错误写法：
Http::post($url, json_encode($data))—— 这会导致双 encode 和类型错配 - 需要发送表单数据（
application/x-www-form-urlencoded）？用asForm()：Http::asForm()->post(...) - 上传文件暂不支持原生
Http，得回退到 Guzzle 手动构造 multipart
示例：
$response = Http::post('https://api.example.com/users', [
'name' => 'Taylor',
'email' => 'taylor@example.com'
]);
错误处理别只靠 try-catch
Http 的异常机制分两层：网络层异常（如 DNS 失败、连接超时）会抛 Illuminate\Http\Client\ConnectionException；HTTP 层异常（如 404、500）默认不抛，除非调用 throw()。
很多开发者只写 try-catch 却漏掉 throw()，结果 404 被当成成功处理，后续 $response->json() 可能返回 null 或结构错乱。
- 推荐组合：
Http::timeout(5)->throw()->get(...)，让所有非 2xx 都抛异常 - 想区分错误类型？捕获具体异常：
ConnectionException（网络问题）、RequestException（4xx）、ServerException（5xx） - 日志记录时，记得打上
$response->body()或$response->status()，光记 URL 没用 - 重试逻辑别手写，用
retry(3, 100)（3 次，间隔 100ms）更稳
真正难的不是发请求，而是判断什么时候该重试、什么时候该降级、什么时候该告警——这些得结合业务状态码和响应体内容来定，Http 本身不替你决策。
