GCP PubSub PHP长轮询cURL连接未关闭致FD表满的解决方法

代码存在两个核心问题导致文件描述符泄漏：

• 你在while(true)无限循环内部重复实例化topic、subscription对象，每次实例化都会在底层新建Guzzle HTTP客户端、新建cURL句柄，旧对象未被正确回收时就会残留处于CLOSE_WAIT状态的连接
• Google Cloud PHP PubSub的REST连接默认复用Guzzle客户端的连接池，但重复创建顶层资源对象的写法会绕过连接复用逻辑，持续占用新的文件描述符，几小时累积下来就会打满进程FD上限

1. 修正资源实例化逻辑（优先采用） #

把PubSub客户端、Topic、Subscription对象的初始化全部移到循环外部，只实例化一次，循环内直接复用实例即可，从根源避免重复创建HTTP连接：

// 循环外一次性初始化所有可复用对象
$this->pubsub = new PubSubClient([
    'keyFile' => json_decode(file_get_contents(base_path() . '/' . env('GOOGLE_APPLICATION_CREDENTIALS')), true)
]);
$topic = $this->pubsub->topic('topic-name');
$subscription = $topic->subscription('subscription-name');

while (true) {
    // 循环内直接复用已实例化的subscription对象拉取消息
    $messages = $subscription->pull();
    
    // 业务消息处理逻辑
    // ...
    // 处理完成后务必调用ack确认消息，避免重复拉取
    if (!empty($messages)) {
        $subscription->acknowledge($messages);
    }
    
    // 增加适当拉取间隔，避免无意义空轮询打满CPU
    usleep(100000); // 间隔100ms，可根据业务吞吐要求调整
}

2. 配置Guzzle客户端主动回收句柄（兜底方案） #

如果因业务逻辑必须在循环内创建新的连接，可以在初始化PubSubClient时自定义Guzzle客户端配置，强制请求完成后关闭cURL连接，避免连接残留：

use GuzzleHttp\Client;

$this->pubsub = new PubSubClient([
    'keyFile' => json_decode(file_get_contents(base_path() . '/' . env('GOOGLE_APPLICATION_CREDENTIALS')), true),
    'restClientOptions' => [
        'client' => new Client([
            'curl' => [
                CURLOPT_FORBID_REUSE => true,
                CURLOPT_FRESH_CONNECT => true
            ]
        ])
    ]
]);

注意：该方案会让每次请求都新建TCP连接，性能比连接复用方案低30%以上，仅作为特殊场景下的兜底选择

3. 增加常驻进程FD泄漏防护机制 #

针对Laravel常驻命令场景，增加两层防护：

• 用pcntl_signal注册信号处理逻辑，进程收到重启、终止信号时主动触发资源释放
• 给循环增加执行次数计数，每处理N轮（比如1000次拉取）就主动退出当前进程，配合Supervisor等进程守护工具自动拉起新进程，彻底释放残留的FD资源

$maxRounds = 1000;
$currentRound = 0;
while (true) {
    $currentRound++;
    if ($currentRound >= $maxRounds) {
        // 到达执行轮次上限，主动退出让守护进程重启
        exit(0);
    }
    // 原有拉取、消息处理逻辑
    // ...
}

4. 临时调大系统FD上限（应急方案） #

如果线上已经出现故障需要临时恢复，可以先调大进程可打开的文件描述符上限临时缓解，后续再落地前面的代码修复方案：

# 临时设置当前shell启动的进程FD上限为65535
ulimit -n 65535

注意：该方案仅能延缓故障出现时间，无法从根源解决连接泄漏问题

额外说明：官方PubSub库没有提供单独的关闭连接方法，是因为REST连接的生命周期完全绑定底层Guzzle客户端和cURL句柄，只要不重复创建客户端实例、正确复用对象，PHP的引用回收机制会自动释放不再使用的连接资源，不需要手动调用关闭方法。

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