Electron 保活方案:用子进程彻底解决原生插件崩溃问题

项目引入 Node 原生插件(.node) 后,出现高崩溃率主进程阻塞问题。

通过 child_process + fork 子进程 实现插件保活,保证系统稳定运行。

【process】

  • 全局对象,直接用,不用require
  • 代表当前运行的Node.js进程
  • 一个应用启动后只有一个主进程
  • 作用:获取进程信息、环境变量、程序退出、系统信号监听等

【child process】

  • Node.js内置模块,必须require('child_process')
  • 作用:在主进程中创建独立子进程
  • 子进程可以执行:其他Node脚本、JS/TS、shell命令、Native插件
  • 目的:解决单线程阻塞、利用多核CPU、崩溃隔离,保证主进程稳定

【fork子进程机制】(保活核心)

  1. fork作用:

    • 创建全新独立的Node.js进程
    • 运行指定的JS/TS文件
    • 父子进程完全隔离、不共享内存
  2. process指向规则(关键)

    • fork外部文件:process = 主进程
    • fork内部文件:process = 当前子进程

【electron为什么要把Native插件放进fork子进程】

  • 避免阻塞主进程 / UI线程
  • 插件崩溃不会导致整个应用崩溃,可自动重启
  • 主进程职责更清晰:只负责生命周期管理+IPC转发
  • 实现插件保活,提升应用稳定性

【核心总结】

  • Nodejs是单线程,主进程若做大量计算或插件逻辑会直接阻塞,卡死甚至崩溃

而child_process可以:

  • 开启新进程,分担密集型任务
  • 子进程崩溃不影响主进程
  • 充分利用多核CPU
  • 实现崩溃自动重启(保活机制)

【实践】

插件相关API必须放在fork子进程中,主进程只负责

  • 启动子进程
  • 管理子进程生命周期
  • 将子进程事件转发给渲染进程

【好处】

  • 避免native模块阻塞主进程的UI线程
  • native模块崩溃不会导致整个Electron应用崩溃(子进程可以重启)
  • 主进程代码更清晰,只处理 IPC 转发

fork的作用:启动一个全新的process(新进程),运行指定文件,父子是两个完全独立的进程

结构图:

代码示例:

keepAlive:【主进程fork + 保活】

复制代码
import { fork } from 'child_process';
const isDev = process.env.NODE_ENV === 'development';
let worker;
function startWorker() {

    const workerPath = isDev
    ?
    path.join(__dirname, 'nodeplugin.ts')
    :
    path.join(__dirname, 'nodeplugin.js');
    
    // 启动子进程
    worker = fork(
        workerPath,
        [],
        {
            execArgv: isDev
                ?
                ['-r', 'ts-node/register/transpile-only']
                :
                [],
            env: {
                ...process.env,
                ELECTRON_IS_PACKAGED: isDev ? 'true' : 'false'
            }
        }
    );
    
    worker.on('spawn', () => {
        // 触发通信:向子进程发送通信
        worker!.send({type: '', data: null})
    })
    
    worker.on('message', (msg) => {
        console.log('插件返回:', msg);
    });
    
    worker.on('exit', (code, signal) => {
        // 非正常退出
        if (code !== 0) {
            console.warn(`[蓝牙进程] 异常退出 code=${code},准备重启`); 
            restartWorker();
        } else {
            console.log(`[蓝牙进程] 正常退出`);
        }
    });
}
    
function restartWorker() {
    if(!worker) return;
    
    // 清理旧 worker
    worker.removeAllListeners();
    worker.kill();
    worker = null;
    
    // 重新启动
    startWorker()
}

pluginNode.ts【子进程】

复制代码
const native = require('./xxx.node');

// 接收主进程消息
process.on('message', (msg) => {

    console.log(msg)
    
    // 处理逻辑
    switch(msg.type) {
        case 'case1':
            ...
            break;
        .
        .
        .
    }
    
    // 触发通信:向外层woker发送数据,实现回传
    process.send(result);
});

【父子进程通信坑点:Uint8Array类型丢失】

  • 在跨进程传输后Uint8Array变成了普通对象,导致无法使用byteLength等属性

【现象】:

  • 子进程里:Uint8Array(39) [...] (类型化数组)
  • 父进程收到:{ '0': 0, '1':0 ... } (普通对象)
  • 未做任何转换 → 但类型自动改变。

【根本原因】:

  • 进程之间不能直接共享内存

  • 跨进程 IPC 必须经过序列化,才能跨进程传递

  • Node 对 TypedArray / Uint8Array 的序列化规则:自动转为「索引 - 值」普通对象

    复制代码
      子进程:Uint8Array
            ↓
      IPC 序列化(自动)
            ↓
      父进程:普通对象 { 0:xx, 1:xx ... }

【解决方案】

  • 传输时用: const value = Array.from(payload)
  • 接收时用: const payloadArray = Uint8Array.from(payload);

【最终总结】

  1. 主进程 = process,全局唯一,严禁阻塞

  2. child_process.fork() = 创建独立子进程

  3. Native插件必须放在子进程,防止崩溃拖垮整个应用

  4. 子进程崩溃 → 主进程自动重启 → 实现保活

  5. Uint8Array跨进程会变对象 → 使用Array.form / new Uint8Array还原

相关推荐
还有多久拿退休金4 小时前
DragSortTable:一个让我怀疑人生的滚动重置 Bug
前端
渐儿4 小时前
组件库开发入门到生产(从零封装到 npm 发布)
前端
小领航4 小时前
构建 MySQL MCP Server
人工智能·node.js
KaMeidebaby4 小时前
卡梅德生物技术快报|单 B 细胞抗体制备:流程优化、表达系统适配与性能数据
前端·数据库·其他·百度·新浪微博
lichenyang4534 小时前
从鸿蒙 AI 聊天 Demo 学习 ArkUI V2:第一天上手记录
前端
进击的松鼠5 小时前
OpenClaw 的五层架构设计与解析
前端·架构·agent
JavaGuide5 小时前
Claude Code 新功能Agent View 发布:终于不用在一堆终端窗口里找 Agent 了!
前端·后端·agent
不简说5 小时前
前端可视化打印设计器sv-print,一口气更新了30版
前端·源码·产品
颖火虫盟主5 小时前
Claude Code Hook 系统详解与 Hello World 实操
前端·网络·数据库
JavaGuide5 小时前
Claude Code + BrowserAct,夯爆了!一句话让 AI 帮你操控浏览器。
前端·后端·ai编程