Node.js Puppeteer per-page proxy插件出现proxy connection error与ERROR_FAIL报错求助

错误根因定位 #

• puppeteer-page-proxy插件长期未更新，对新版Puppeteer的请求拦截API兼容存在缺陷，socks5代理的协议头解析逻辑存在bug，会触发无明确原因的ERROR_FAIL报错
• 插件全局拦截所有请求时未做异常捕获，代理握手失败、响应超时等场景会直接抛出未处理错误
• 与Chrome新版的网络隔离策略存在冲突，单页请求转发时会被跨域安全规则拦截

可行解决方案 #

方案1：修复原有插件的配置逻辑 #

执行以下步骤修复问题：

1. 给所有socks5代理地址添加完整协议头，示例格式为socks5://username:password@代理IP:端口，不可省略socks5://前缀
2. 开启请求拦截时添加异常捕获逻辑，参考代码如下：

const useProxy = require('puppeteer-page-proxy');
// 单页代理配置
page.on('request', async req => {
  try {
    await useProxy(req, 'socks5://127.0.0.1:1080');
  } catch (err) {
    // 捕获代理错误，避免未处理异常中断程序
    if (err.message.includes('ERROR_FAIL')) {
      req.abort('failed');
    }
  }
});

3. 若仍报错，卸载官方npm包后安装社区修复的fork版本：npm i @xcaret/puppeteer-page-proxy，该版本修复了socks5协议解析的已知bug

方案2：使用原生Puppeteer上下文实现单页独立代理（更稳定，无需第三方插件） #

Puppeteer支持为每个独立的BrowserContext配置单独代理，完全满足单页独立代理的需求，兼容性远高于第三方插件，参考代码如下：

const puppeteer = require('puppeteer');
const browser = await puppeteer.launch();
// 为每个代理创建独立上下文
const proxyContext1 = await browser.createIncognitoBrowserContext({
  proxyServer: 'socks5://127.0.0.1:1080'
});
const proxyContext2 = await browser.createIncognitoBrowserContext({
  proxyServer: 'http://192.168.1.1:8080'
});
// 不同上下文创建的页面自动使用对应代理
const page1 = await proxyContext1.newPage();
const page2 = await proxyContext2.newPage();

注意事项 #

• 所有代理地址需提前通过curl等工具验证连通性，确认无认证失败、端口不通等问题
• 上下文代理方案不支持单个页面中途切换代理，若需动态切换代理可结合页面重载+上下文切换实现
• 配置带认证的代理时，需额外调用page.authenticate()方法传入用户名和密码

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