Laravel中Guzzle创建过多TCP连接导致502超时问题求助

1. 正确注册带连接池的Guzzle客户端单例 #

问题核心在于你每次都新建Client实例——哪怕Handler是单例，新创建的Client也无法复用之前的连接池。应该直接把Client注册为单例，同时配置连接复用相关参数：

在AppServiceProvider的register方法中修改代码：

use GuzzleHttp\Client;
use GuzzleHttp\Handler\CurlHandler;
use GuzzleHttp\HandlerStack;

public function register()
{
    $this->app->singleton(Client::class, function ($app) {
        $curlHandler = new CurlHandler();
        $handlerStack = HandlerStack::create($curlHandler);

        return new Client([
            'handler' => $handlerStack,
            // 启用HTTP长连接（keep-alive）
            'headers' => [
                'Connection' => 'keep-alive',
            ],
            // 配置CURL持久化连接参数
            'curl' => [
                CURLOPT_TCP_KEEPALIVE => 1,
                CURLOPT_TCP_KEEPIDLE => 60,   // 连接闲置60秒后开始发送保活包
                CURLOPT_TCP_KEEPINTVL => 10,  // 每10秒发送一次保活包
            ],
            // 全局请求超时（按需调整）
            'timeout' => 15,
        ]);
    });
}

2. 控制器中直接复用单例Client #

不要手动创建Client实例，通过依赖注入获取已注册的单例：

use GuzzleHttp\Client;

class YourController extends Controller
{
    public function yourApiEndpoint(Client $client)
    {
        // 直接使用注入的Client发起请求，连接会自动复用
        $response = $client->get('https://third-party-service.com/target-endpoint');
        // ...后续业务逻辑处理
    }
}

3. 额外优化建议 #

• 调整PHP-FPM配置：高并发场景下，确保PHP-FPM的pm.max_children进程数足够，同时设置request_terminate_timeout避免进程挂死。
• 使用Guzzle并发请求池：如果业务允许批量调用第三方接口，用Pool类批量发起请求，进一步提升连接复用效率：

use GuzzleHttp\Pool;
use GuzzleHttp\Psr7\Request;

// 生成批量请求
$requests = function ($total) {
    for ($i = 0; $i < $total; $i++) {
        yield new Request('GET', 'https://third-party-service.com/target-endpoint');
    }
};

// 初始化并发池
$pool = new Pool($client, $requests([
    'concurrency' => 50, // 并发数根据服务器配置调整
    'fulfilled' => function ($response, $index) {
        // 处理成功响应
    },
    'rejected' => function ($reason, $index) {
        // 处理失败请求
    },
]));

// 执行并发请求
$promise = $pool->promise();
$promise->wait();

• 第三方服务兼容性检查：如果第三方服务不支持keep-alive，可以考虑替换为Swoole协程客户端，底层会自动维护连接池，适配高并发场景。

内容的提问来源于stack exchange，提问作者Mireko