如何避免Electron启动多应用实例？解决幽灵进程残留问题

问题根源 #

官方文档的requestSingleInstanceLock+app.quit()方案，在部分场景下无法彻底终止所有衍生进程：app.quit()会触发优雅退出流程，等待事件循环清空，但若此时渲染进程、子进程已启动，可能因异步清理未完成导致进程残留。

修复代码 #

调整退出逻辑，用强制终止替代优雅退出，并确保锁检查在应用初始化早期执行：

export const onAppTryLaunch = () => {
  const gotTheLock = app.requestSingleInstanceLock();

  if (!gotTheLock) {
    // 强制终止所有进程，避免优雅退出导致的残留
    app.exit(0);
  } else {
    app.on('second-instance', () => {
      openMainWindow(); // 聚焦/恢复主窗口的自定义函数
    });

    // 可选：主进程退出时主动清理自定义子进程
    app.on('before-quit', () => {
      // 若存在自行创建的子进程，在此手动终止
      // 示例：if (myChildProcess) myChildProcess.kill('SIGTERM');
    });
  }
};

关键注意事项 #

• 调用时机：确保onAppTryLaunch在app.on('ready')事件触发前执行，避免Electron初始化渲染进程等资源后再退出，减少残留概率。
• 子进程处理：若应用启动时会创建自定义子进程（如后台服务、第三方工具进程），需在app.exit()前手动终止这些进程，它们可能不受Electron默认退出流程管理。
• 依赖排查：检查是否有第三方依赖、插件在启动阶段创建了独立进程，这类进程需针对性处理（如调用其退出API或发送终止信号）。

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