Hyperf 3.1.66 原生支持 Guzzle 持久化 Cookie，但需显式复用同一 Client 实例并注入可复用的 CookieJar，而非依赖 'cookies' => true 的单次开关；默认每次 create() 生成新 client 导致 Cookie 不共享。
Hyperf 3.1.66 确实原生支持 Guzzle 的持久化 Cookie，但不是开箱即用——它依赖你显式启用 CookieJar 并正确复用客户端实例。
为什么默认请求不带 Cookie？
Hyperf 的 ClientFactory 默认创建的是无状态 GuzzleHttp\Client 实例，每次调用 create() 都会生成全新 client，CookieJar 不跨实例共享。即使你在配置里加了 'cookies' => true，也只对单次请求生效，不会自动累积。
- 典型现象：
login接口返回了Set-Cookie，但后续get('/profile')却 401 - 根本原因：没把
CookieJar实例绑定到 client，或每次请求都 new 了一个 client - 注意：
'cookies' => true是 Guzzle 自己的快捷开关，它内部会 new 一个CookieJar，但生命周期仅限当次请求
如何真正实现跨请求 Cookie 持久化？
关键不是配开关，而是复用同一个 GuzzleHttp\Client 实例，并注入可复用的 CookieJar。
- 在 service 中缓存 client 实例，不要每次方法都
$this->clientFactory->create() - 手动构造
CookieJar，传入 client 配置：'cookies' => new \GuzzleHttp\Cookie\CookieJar() - 如果需要预加载初始 Cookie（比如从 session 或 header 解析），用
CookieJar::fromArray() - 避免在协程间共享同一个
CookieJar实例——它非线程/协程安全；应在每个协程上下文里新建或 clone
// 正确示例：复用 client + 可控 CookieJar
use GuzzleHttp\Cookie\CookieJar;
class AuthService
{
private \GuzzleHttp\Client $client;
public function __construct(ClientFactory $clientFactory)
{
$jar = new CookieJar();
$this->client = $clientFactory->create([
'base_uri' => 'https://api.example.com',
'cookies' => $jar,
'timeout' => 5.0,
]);
}
public function login(): void
{
$this->client->post('/login', ['form_params' => [...]]);
// Cookie 已写入 $jar，下次请求自动携带
}
public function getProfile(): array
{
$res = $this->client->get('/profile'); // 自动带上上一步登录的 Cookie
return json_decode($res->getBody()->getContents(), true);
}
}
Hyperf 3.1.66 的 Guzzle 协程适配与 Cookie 冲突点
Hyperf 的协程化 Guzzle handler 本身不干涉 Cookie 逻辑，但会放大两个常见误用：
- 在
onStart或onWorkerStart中提前初始化 client 并注入全局CookieJar——这会导致所有协程共用一套 Cookie，身份混杂 - 使用
getAsync()后忘记wait()或Promise::settle()，导致CookieJar更新未同步到后续请求 -
CookieJar默认只保存 session cookie（无Expires字段），若需持久化，得手动调用$jar->setCookie()注入带过期时间的SetCookie对象
最易被忽略的一点：Hyperf 的 ClientFactory 创建的 client 默认启用了连接池，而 CookieJar 是 client 实例级别的，不是连接池级别的——这意味着只要复用 client 实例，Cookie 就自然持久；但如果你误以为“连接池=状态共享”，就可能绕远路去自己管理 cookie 字符串。
