解决Google Cloud Function v2中Puppeteer实例连接被拒问题

问题根源 #

Google Cloud Function（GCF）v2的运行环境是封闭的服务器容器，容器内部的localhost端口不会暴露到公网。你复制的WebSocket端点（格式类似ws://localhost:xxxx/devtools/browser/xxx）仅能在函数容器内部访问，外部客户端无法直接连接，因此会抛出「远程计算机拒绝连接」的错误。

另外，GCF是事件驱动的无服务器服务，函数实例生命周期极短（触发后启动，执行完成即销毁），本身就不适合长期保持WebSocket连接供外部访问。

解决方案 #

方案1：重构函数逻辑，让函数直接处理Puppeteer任务

放弃从外部连接函数内的Puppeteer，改为让GCF本身完成你需要的Puppeteer操作，再将结果返回给客户端。流程如下：

1. 客户端发送HTTP请求触发函数
2. 函数内部启动Puppeteer，执行爬取、截图、生成PDF等操作
3. 函数将操作结果（如图片、结构化数据）返回给客户端

示例修改后的Node.js函数代码：

import puppeteer from "puppeteer-extra";

export const runPuppeteerTask = async (req, res) => {
  const browser = await puppeteer.launch({
    args: ['--no-sandbox', '--disable-setuid-sandbox'] // GCF环境必需的权限参数
  });
  const page = await browser.newPage();
  await page.goto('https://example.com');
  
  // 执行你需要的操作，比如截图
  const screenshot = await page.screenshot();
  
  await browser.close();
  res.set('Content-Type', 'image/png');
  res.send(screenshot);
};

方案2：迁移到支持公网端口暴露的服务（若必须远程连接Puppeteer）

如果你的场景确实需要外部客户端直接连接Puppeteer的WebSocket端点（比如远程调试），请将Puppeteer部署到以下服务：

• Cloud Run：部署包含Puppeteer的容器镜像，配置端口暴露（如指定--remote-debugging-port=9222），通过Cloud Run提供的公网域名访问WebSocket端点（wss://<your-cloud-run-domain>:443/devtools/browser/xxx）
• Compute Engine：创建虚拟机，开放防火墙规则允许外部访问Puppeteer的调试端口，直接通过虚拟机公网IP连接
• GKE：部署Puppeteer Pod，配置Service暴露端口，通过负载均衡或NodePort访问

关键注意事项 #

• GCF环境中运行Puppeteer必须添加--no-sandbox和--disable-setuid-sandbox启动参数，否则会因沙箱权限问题无法启动
• 不要尝试在GCF中暴露内部端口供外部访问，这不符合无服务器服务的设计模式，也无法通过常规配置实现

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