Yii HttpClient发送GET请求需调用$response->getContent()再json_decode()；URL路径漏/导致404；POST发JSON须setFormat(FORMAT_JSON)并显式设Content-Type头；Bearer Token需手动addHeaders(['Authorization'=>'Bearer '.$token])；并发需换Guzzle或cURL multi，非线程安全需每次新建实例。
Yii HttpClient 发送 GET 请求拿不到数据？检查 baseUrl 和 send() 返回值
Yii 的 HttpClient 默认不自动解析响应体，send() 返回的是 yii\httpclient\Response 对象，不是 JSON 数据本身。直接 var_dump($response) 看到的是一堆对象属性，容易误以为“没返回”。
- 用
$response->getContent()拿原始响应体（字符串），再手动json_decode() - 如果设置了
baseUrl（比如https://api.example.com/v1），请求路径写/users就会拼成完整 URL；但若漏写开头的/，比如写成users，就会变成https://api.example.com/v1users—— 404 就这么来的 - 默认超时是 30 秒，第三方 API 响应慢时可能卡住，建议显式设
timeout => 10
POST 提交 JSON 数据总被对方拒收？注意 setFormat() 和 addHeaders()
Yii HttpClient 的 POST 默认发 application/x-www-form-urlencoded，不是 JSON。哪怕你传的是数组，它也会 urlencode，对方后端收不到 $_POST 或等效结构。
- 必须链式调用
->setFormat(yii\httpclient\Client::FORMAT_JSON) - 同时手动加头：
->addHeaders(['Content-Type' => 'application/json'])（虽然FORMAT_JSON本该自动加，但某些 Yii 版本有 bug，显式写更稳） - 传参直接给关联数组，
HttpClient会自动json_encode：比如->setData(['name' => 'Alice', 'email' => 'a@b.c']) - 别用
->setBody(json_encode(...))—— 这样会双重编码，对方收到的是字符串化的 JSON
调用需要 Bearer Token 的 API 总是 401？Authorization 头要手写，别信文档里的“自动支持”
Yii HttpClient 没有内置 setBearerToken() 这种快捷方法，所谓“支持 OAuth”只是指它能发带 header 的请求，Token 还得自己塞。
- 正确写法：
->addHeaders(['Authorization' => 'Bearer ' . $token]) -
$token必须是已解码、未过期的字符串，别传整个 JWT token 对象或加密后的密文 - 如果 token 存在配置文件里，确保没混入空格或换行（尤其从 env 文件读取时）
- 调试时用
$response->getHeaders()->get('Authorization')查不到值 —— 这个 header 是发出去的，不是对方返回的，得用抓包或日志看实际发出的请求
并发请求卡死或超时？HttpClient 不是天生异步，别直接 for 循环发一堆
Yii HttpClient 底层用的是 PHP 的 cURL 或 stream，单次请求是同步阻塞的。10 个请求串行发，耗时就是 10 倍单次延迟。
- 真要并发，得用
cURL multi手动封装，或者换GuzzleHttp\Client（兼容 Yii 环境，且原生支持 Promise） - Yii 自带的
BatchRequest并不适用于调第三方 API，它是为 ActiveRecord 批量操作设计的，和 HTTP 无关 - 简单降级方案：加
try/catch包住每个请求，设置短超时（如 3 秒），失败就跳过，别让一个慢请求拖垮全部
最常被忽略的一点：Yii HttpClient 实例不是线程安全的，如果在长生命周期服务（如 Swoole Worker）里复用同一个实例发不同请求，header 和 config 可能互相污染。每次请求最好新建实例，或至少调用 reset()。
