Playwright测试Electron应用时electron.launch偶发超时问题

问题背景 #

使用Playwright为Electron应用编写端到端测试时，出现偶发的启动超时异常：调用const electronApp = await electron.launch(launchOptions);时，Electron应用已正常启动并可交互，但该await语句始终无法resolve，最终触发超时。具体特征：

• 问题随机出现，Playwright 1.29.2版本存在，升级至更高版本后出现频率上升，但仍有测试能通过
• 代码执行到channelOwner.js中的sendMessageToServer方法并发送prop='launch'后，对应的Promise始终无法完成
• 已验证相关方案中提到的fuse已启用，对应解决方案无效；nodeCliInspect fuse也已开启
• 延长超时时间、尝试Playwright调试器（界面空白无法连接）均无法解决问题

可行排查与解决方向 #

1. 捕获Electron启动日志定位阻塞点 #

在启动配置中开启Electron日志输出，同时配置Playwright的日志捕获，查看应用启动过程中是否有异常IPC通信或进程阻塞：

const electronApp = await electron.launch({
  ...launchOptions,
  env: { ...process.env, ELECTRON_ENABLE_LOGGING: '1' },
  logger: {
    info: msg => console.log(`[Electron Info] ${msg}`),
    error: msg => console.error(`[Electron Error] ${msg}`)
  }
});

2. 手动指定IPC端口避免冲突 #

偶发的端口自动分配冲突可能导致Playwright与Electron的IPC通信中断，手动指定固定端口：

const electronApp = await electron.launch({
  ...launchOptions,
  args: [...(launchOptions.args || []), '--inspect-port=9229']
});

3. 临时禁用Electron沙箱验证兼容性 #

部分环境下沙箱机制会干扰IPC通信，尝试禁用沙箱验证是否解决问题：

const electronApp = await electron.launch({
  ...launchOptions,
  args: [...(launchOptions.args || []), '--no-sandbox', '--disable-setuid-sandbox']
});

4. 降级Playwright版本验证兼容性 #

由于升级后问题频率上升，可尝试降级到1.28.x版本（如1.28.1），该版本在Electron启动IPC逻辑上更稳定。

5. 检查Electron主进程的异步阻塞 #

即使应用界面可交互，主进程可能存在未完成的异步任务或同步阻塞代码，导致Playwright的launch回调无法触发。可在Electron主进程的app.whenReady()后添加日志，确认主进程是否完全就绪，同时排查是否有长时间运行的同步操作阻塞IPC通道。

内容的提问来源于stack exchange，提问作者Dylan Storing-O'Dowd