当前位置：首页 > news >正文

终极指南：Electron-Egg主进程与渲染进程错误处理完整对比

news 2026/4/1 16:07:12

终极指南：Electron-Egg主进程与渲染进程错误处理完整对比

【免费下载链接】electron-eggA simple, cross platform, enterprise desktop software development framework项目地址: https://gitcode.com/dromara/electron-egg

Electron-Egg是一个简单、跨平台的企业级桌面软件开发框架，它基于Electron构建，为开发者提供了快速构建桌面应用的能力。在Electron应用开发中，正确处理主进程与渲染进程的错误是确保应用稳定性的关键。本文将详细对比Electron-Egg框架中主进程与渲染进程的错误处理机制，帮助开发者更好地理解和应用这些技术。😊

🔍 为什么需要区分主进程与渲染进程错误处理？

在Electron架构中，主进程运行Node.js环境，负责窗口管理、系统交互等核心功能；渲染进程运行Chromium浏览器环境，负责UI展示。两者的错误处理机制完全不同：

主进程错误：可能导致整个应用崩溃
渲染进程错误：通常只会影响单个窗口或页面
通信错误：主进程与渲染进程间的IPC通信可能出现异常

📁 框架配置中的错误日志设置

在Electron-Egg的配置文件electron/config/config.default.js中，已经内置了错误日志配置：

logger: { level: 'INFO', outputJSON: false, appLogName: 'ee.log', coreLogName: 'ee-core.log', errorLogName: 'ee-error.log' // 专门记录错误日志 }

这个配置确保了所有进程的错误都能被统一记录到ee-error.log文件中，便于问题追踪和分析。

Windows系统下的Electron-Egg界面 - 展示了通信模块的异步/同步消息处理

🔧 主进程错误处理最佳实践

1. 全局异常捕获

在主进程的入口文件electron/main.js中，应该添加全局异常捕获：

process.on('uncaughtException', (error) => { console.error('主进程未捕获异常:', error); // 记录到错误日志 logger.error('主进程崩溃:', error); }); process.on('unhandledRejection', (reason, promise) => { console.error('未处理的Promise拒绝:', reason); logger.error('Promise拒绝:', reason); });

2. 控制器层的错误处理

在electron/controller/example.js中，控制器方法应该包含错误处理：

async test() { try { const result = await exampleService.test('electron'); logger.info('service result:', result); return 'hello electron-egg'; } catch (error) { logger.error('控制器执行失败:', error); throw error; // 向上抛出，由IPC层处理 } }

🎨 渲染进程错误处理技巧

1. 前端错误捕获

在Vue组件中，可以使用全局错误处理器：

// 在Vue应用初始化时添加 app.config.errorHandler = (err, vm, info) => { console.error('Vue错误:', err, info); // 可以通过IPC发送错误信息到主进程 if (window.electron?.ipcRenderer) { window.electron.ipcRenderer.send('renderer-error', { error: err.toString(), component: vm?.$options.name, info }); } };

2. 窗口级错误处理

在渲染进程中，可以监听窗口级别的错误：

window.addEventListener('error', (event) => { console.error('窗口错误:', event.error); // 阻止错误冒泡到控制台 event.preventDefault(); // 友好错误提示 showErrorToast('应用出现错误，请刷新页面重试'); return false; });

macOS系统下的Electron-Egg界面 - 跨平台错误处理需要保持一致的用户体验

🔄 IPC通信的错误处理对比

主进程端（ipcMain）

// 在electron/preload/bridge.js中暴露API const { contextBridge, ipcRenderer } = require('electron'); contextBridge.exposeInMainWorld('electron', { ipcRenderer: ipcRenderer, }); // 在控制器中处理IPC调用 ipcMain.handle('api-call', async (event, args) => { try { const result = await controller.method(args); return { success: true, data: result }; } catch (error) { logger.error('IPC调用失败:', error); return { success: false, error: error.message, code: error.code || 'UNKNOWN_ERROR' }; } });

渲染进程端（ipcRenderer）

在frontend/src/utils/ipcRenderer.js中，提供了IPC工具：

// 异步调用示例 async function callAPI(channel, params) { try { const response = await ipc.invoke(channel, params); if (response.success) { return response.data; } else { throw new Error(response.error || 'API调用失败'); } } catch (error) { console.error(`调用 ${channel} 失败:`, error); // 显示用户友好的错误信息 showNotification(`操作失败: ${error.message}`); throw error; } }

📊 数据库操作错误处理实例

Ubuntu系统下的数据库模块 - 展示了本地数据操作的错误处理场景

在数据库操作中，错误处理尤为重要：

// 数据库服务层错误处理 class DatabaseService { async addData(data) { try { // 数据验证 if (!data.name || !data.age) { throw new Error('姓名和年龄不能为空'); } // 数据库操作 const result = await db.insert(data); return { success: true, id: result.id }; } catch (error) { // 区分错误类型 if (error.code === 'FILE_NOT_FOUND') { logger.warn('数据库文件不存在，正在创建...'); await this.initDatabase(); return this.addData(data); // 重试 } else if (error.code === 'DISK_FULL') { throw new Error('磁盘空间不足，请清理后重试'); } else { logger.error('数据库操作失败:', error); throw new Error('数据保存失败，请稍后重试'); } } } }