如何在Electron.js应用中优雅处理信号？Windows平台遇Crashpad问题

问题说明 #

• 用Node扩展通过std::signal实现自定义信号处理（比如捕获段错误），在Electron的macOS环境下正常工作
• 换到Windows平台后，自定义处理器完全失效，应用崩溃时控制台输出：

[10208:0815/181127.900:ERROR:crashpad_client_win.cc(814)] not connected

• 相同的Node扩展在纯Node.js的Windows环境里能正常运行

问题根因 #

Electron基于Chromium，默认启用了Crashpad崩溃捕获机制，它会接管Windows上的异常处理（包括信号、结构化异常），直接覆盖了你用std::signal注册的自定义处理器，导致你的逻辑触发不了。而纯Node.js没集成Crashpad，所以信号处理能正常生效。

解决办法 #

办法1：禁用Electron的Crashpad（仅调试用） #

在Electron主进程启动前，通过命令行参数关掉Crashpad：

// 主进程代码
const { app } = require('electron');

// 在app ready之前添加参数
app.commandLine.appendSwitch('disable-crashpad');

app.on('ready', () => {
  // 你的应用逻辑
});

关掉后，Windows的异常会回到系统默认处理，你的std::signal处理器就能正常触发。但要注意，这会让Electron自带的崩溃报告功能失效，别在生产环境用。

办法2：用Electron自带的崩溃事件替代 #

直接用Electron提供的事件来做自定义处理，不用依赖Node扩展的信号逻辑：

• 监听渲染进程崩溃：

// 主进程代码
const { app, BrowserWindow } = require('electron');

app.on('ready', () => {
  const mainWindow = new BrowserWindow();
  
  mainWindow.webContents.on('render-process-gone', (event, details) => {
    // 这里写你的自定义崩溃处理逻辑
    console.log('渲染进程崩了，原因：', details.reason);
    // 比如重启窗口、写日志之类的
  });
});

• 主进程JS层的崩溃可以用uncaughtException和unhandledRejection捕获；如果是C++层的崩溃，改用Windows的结构化异常处理（SEH）：

// Node扩展的C++代码（Windows专属）
#include <windows.h>

LONG WINAPI CustomExceptionHandler(EXCEPTION_POINTERS* exceptionInfo) {
  // 自定义崩溃处理逻辑，比如记录崩溃信息
  return EXCEPTION_CONTINUE_SEARCH; // 让Crashpad继续处理，也可以返回EXCEPTION_EXECUTE_HANDLER直接终止
}

void init(v8::Local<v8::Object> exports) {
  // 注册SEH异常处理器
  SetUnhandledExceptionFilter(CustomExceptionHandler);
}

NODE_MODULE(NODE_GYP_MODULE_NAME, init)

这种方式能和Crashpad共存，先跑你的自定义逻辑，再让Crashpad完成崩溃报告。

办法3：给Crashpad加自定义回调（保留崩溃报告） #

如果要保留Crashpad的崩溃报告功能，同时加自定义处理，可以在Node扩展里对接Crashpad的API注册回调，崩溃时会先触发你的逻辑，再执行Crashpad的默认流程。

注意点 #

• Windows的异常处理和Unix系统不一样，std::signal只能处理部分信号，对付段错误这类硬件异常，用Windows的SEH更靠谱。
• 生产环境别禁用Crashpad，它的崩溃报告功能对排查问题很有用。

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