在 laravel 队列任务中，多个 job 重复创建 guzzle httpclient 会导致频繁建连、无法复用 tcp 连接，显著降低外部 api 调用性能；本文介绍如何通过单例模式+长生命周期队列进程，安全复用同一个带 keep-alive 的 httpclient。
在 laravel 队列任务中，多个 job 重复创建 guzzle httpclient 会导致频繁建连、无法复用 tcp 连接，显著降低外部 api 调用性能；本文介绍如何通过单例模式+长生命周期队列进程，安全复用同一个带 keep-alive 的 httpclient。
在 Laravel 中，当多个队列任务（如 GET_DATA_A、GET_DATA_B）各自独立实例化 Http\Client（默认为 Guzzle），不仅会反复建立 HTTP 连接，还绕过了 HTTP/1.1 的 Keep-Alive 机制和连接池能力，造成资源浪费与响应延迟。根本解法不是“共享客户端实例”本身，而是利用队列工作进程（queue worker）的长生命周期特性，结合依赖注入容器的单例绑定，实现跨 Job 的 HttpClient 复用。
✅ 正确实现方式（推荐）
在 App\Providers\AppServiceProvider::register() 中注册单例 HttpClient：
use GuzzleHttp\Client;
use Illuminate\Support\Facades\Http;
public function register()
{
$this->app->singleton('http.client', function ($app) {
return new Client([
'base_uri' => 'https://api.example.com/',
'timeout' => 30,
'connect_timeout' => 10,
'http_errors' => false,
'headers' => [
'User-Agent' => 'Laravel-Queue-Worker',
'Accept' => 'application/json',
],
// 启用连接复用（Guzzle 默认已启用 keep-alive）
'curl' => [
CURLOPT_TCP_KEEPALIVE => true,
],
]);
});
// 可选：同时绑定到 Illuminate\Http\Client\Factory，保持 Http::fake() 兼容性
$this->app->extend('http.client.factory', function ($factory, $app) {
return $factory->withClient($app->make('http.client'));
});
}
随后，在任意 Job 中通过依赖注入或服务容器获取复用的客户端：
<?php namespace App\Jobs;
use GuzzleHttp\Client;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
class GetDataA implements ShouldQueue
{
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
public function handle(Client $httpClient)
{
$response = $httpClient->get('/endpoint-a');
// 处理数据...
}
}
? 关键前提：确保队列工作进程稳定运行——禁用可能导致进程重启的配置，例如：
Laravel Cloud下载Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- --max-jobs=1 → 改为 --max-jobs=1000 或更高
- --max-time=60 → 建议设为 3600（1 小时）或使用 --max-retries=3 配合优雅退出
- 使用 supervisor 管理 worker，并配置 autorestart=true + startsecs=10
⚠️ 注意事项
- ❌ 不要在 Job 构造函数中 new Client() 或 Http::baseUrl(...) —— 这仍会每次新建实例；
- ✅ 推荐始终通过 Laravel 容器解析（构造函数类型提示或 app('http.client')）；
- ? 若使用 Illuminate\Http\Client\Factory（即 Http::get()），请确保其底层也复用同一 Guzzle 实例（见上方 extend 示例）；
- ? 单例客户端是线程安全的（Guzzle 本身无状态），但注意避免在 Job 中修改其全局配置（如动态设置 base_uri 应改用 withOptions() 临时覆盖）；
- ? 测试时可通过 Http::fake() 模拟请求，它会自动接管单例工厂，不影响复用逻辑。
✅ 效果验证
启用后，可通过 tcpdump 或 Guzzle 日志确认连接复用：
# 查看复用的 TCP 连接（相同端口多次请求） sudo tcpdump -i lo port 443 | grep "ack.*seq"
或启用 Guzzle 调试日志：
'handler' => \GuzzleHttp\HandlerStack::create(
new \GuzzleHttp\Handler\CurlHandler()
),
'log' => 'laravel-http',
最终，多个 Job 将共享底层连接池，显著减少 TLS 握手与 TCP 建连开销，API 平均响应时间可下降 30%~70%，尤其在高并发短任务场景下效果突出。
