Puppeteer在macOS Sequoia系统中socket hang up问题的解决方案

问题背景

近期有开发者反馈，在将macOS系统从Sonoma升级到Sequoia后，使用Puppeteer时遇到了"Error: socket hang up"的错误。这个问题在使用Puppeteer 23.5.1版本和Node.js v22.12.0环境下出现，表现为无法正常启动浏览器实例。

错误现象

当开发者尝试使用以下代码启动Puppeteer时：

const puppeteer = require('puppeteer');

(async () => {
  try {
    const browser = await puppeteer.launch({headless: false});
    const page = await browser.newPage();
    await page.goto('https://www.google.com');
  } catch (error) {
    console.error("Si è verificato un errore:", error);
  }
})();

系统会抛出"Error: socket hang up"错误，并伴随ECONNRESET错误代码。这表明Puppeteer无法与浏览器实例建立稳定的WebSocket连接。

问题分析

这个问题的出现可能与macOS Sequoia系统中的以下变化有关：

1. 系统权限变更：新版本macOS可能引入了更严格的安全策略，影响了Puppeteer启动浏览器的方式
2. 默认浏览器路径问题：系统升级可能导致Puppeteer无法自动定位到正确的浏览器可执行文件路径
3. 网络连接限制：Sequoia可能对本地回环网络连接(127.0.0.1)施加了新的限制

解决方案

经过开发者测试，可以通过显式指定浏览器可执行文件路径来解决此问题：

const browser = await puppeteer.launch({
  headless: false,
  executablePath: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
});

这种方法明确告诉Puppeteer使用哪个浏览器实例，绕过了自动检测可能带来的问题。

深入理解

Puppeteer在macOS系统中启动浏览器时，通常会尝试以下步骤：

1. 检查是否提供了executablePath参数
2. 如果没有提供，尝试查找系统默认安装的Chrome或Chromium浏览器
3. 如果找不到，可能会下载并使用其自带的Chromium版本

在macOS Sequoia中，系统升级可能影响了Puppeteer自动查找浏览器的能力，导致连接失败。显式指定路径可以确保使用正确的浏览器实例。

最佳实践建议

1. 始终指定浏览器路径：即使在旧版本系统中工作正常，也建议显式指定executablePath
2. 考虑使用puppeteer-core：如果项目中已经确保有可用的浏览器，可以使用puppeteer-core减小包体积
3. 处理可能的路径差异：不同macOS版本或不同浏览器安装位置可能导致路径不同，需要适当处理
4. 添加错误处理：对浏览器启动过程添加更详细的错误处理和日志记录

总结

macOS系统升级有时会带来意料之外的兼容性问题。对于Puppeteer这样的工具，显式配置往往比依赖自动检测更可靠。通过指定executablePath，开发者可以确保在不同系统环境中都能稳定运行自动化测试或爬虫程序。