Electron+Spectron基础测试失败：启动10实例后报客户端初始化10次尝试失败

我之前踩过几乎一模一样的坑！这种情况大概率是实例没正确清理或者主进程没及时触发ready信号导致的，咱们一步步来排查：

• 优先检查测试用例的实例销毁逻辑
  这是最常见的原因！如果你的测试框架（比如Mocha/Jest）的钩子函数里，只在beforeEach创建了Application实例，但没在afterEach里调用app.stop()，Spectron会因为前一个实例没就绪而不断重试，直到达到默认的10次重试上限。一定要确保每个测试用例结束后销毁实例：

  let app;
  
  beforeEach(async () => {
    app = new Application({
      path: require('electron'),
      args: [path.join(__dirname, '../src')]
    });
    await app.start();
  });
  
  afterEach(async () => {
    if (app && app.isRunning()) {
      // 强制停止实例，避免残留
      await app.stop();
    }
  });
  

• 检查主进程的ready事件触发逻辑
  Spectron是依赖Electron主进程的ready信号来初始化客户端的，如果主进程里有阻塞操作（比如同步读取大文件、未处理的异步错误），导致app.on('ready')迟迟没执行，Spectron就会不断启动新实例重试。
  你可以在主进程的入口文件里加个日志，确认ready事件是否正常触发：

  const { app } = require('electron');
  
  app.on('ready', () => {
    console.log('Electron主进程已就绪！'); // 测试时看控制台有没有这个输出
    // 你的窗口创建逻辑...
  });
  

• 调整Spectron的超时配置（注意参数位置）
  你提到设置了connectionRetryTimeout但没用，可能是参数传错了位置？要确保在创建Application实例时传入这些配置，而不是全局设置：

  const app = new Application({
    path: require('electron'),
    args: [path.join(__dirname, '../src')],
    startTimeout: 60000, // 给足主进程启动时间，比如60秒
    connectionRetryCount: 3, // 先减少重试次数，避免一下子启动10个实例
    connectionRetryTimeout: 30000
  });
  

• 排查依赖冲突或权限问题

  • 试试清空依赖重新安装：rm -rf node_modules package-lock.json && npm install，有时候旧依赖的冲突会导致Spectron和Electron通信异常。
  • Windows下可以尝试用管理员权限运行测试命令，macOS下检查有没有系统安全设置阻止Electron实例启动。

• 检查测试环境的特殊逻辑
  如果主进程里有根据process.env.NODE_ENV分支的逻辑，看看测试环境下是不是有什么代码导致主进程无法正常启动（比如某个调试插件在测试环境下报错）。

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