electron 默认会在运行时捕获未处理的 javascript 异常并弹出原生错误对话框，影响用户体验；本文详解通过全局异常拦截、渲染进程错误捕获及主进程防护三重策略，彻底屏蔽此类弹窗，同时保留完整日志能力。
electron 默认会在运行时捕获未处理的 javascript 异常并弹出原生错误对话框，影响用户体验；本文详解通过全局异常拦截、渲染进程错误捕获及主进程防护三重策略，彻底屏蔽此类弹窗，同时保留完整日志能力。
Electron 应用中出现的 JS 错误弹窗（如 “A JavaScript error occurred in the main process” 或渲染进程的 Uncaught Error 对话框），并非由 setKiosk(true) 控制——kiosk 模式仅影响窗口外观与用户交互限制，不改变错误处理行为。要真正禁用这些干扰性弹窗，需主动接管各类异常入口点，实现静默捕获 + 可控上报。
✅ 三重防护机制（推荐完整实施）
1. 渲染进程：捕获未捕获的运行时异常
在渲染进程（如 renderer.js 或 Vue/React 入口）中监听 window.onerror 和 window.onunhandledrejection：
// renderer.js
window.onerror = (message, source, lineno, colno, error) => {
console.error('[Renderer Error]', { message, source, lineno, colno, stack: error?.stack });
return true; // 阻止默认弹窗
};
window.onunhandledrejection = (event) => {
console.error('[Renderer Unhandled Rejection]', event.reason);
event.preventDefault(); // 显式阻止默认行为（Electron 14+ 必须调用）
};⚠️ 注意：return true 是关键，它向 Electron 表明该错误已被处理，从而抑制原生弹窗。
2. 主进程：拦截 uncaughtException 与 unhandledRejection
在主进程（main.js）顶部尽早注册：
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
立即学习“Java免费学习笔记（深入）”；
// main.js —— 放在 app.whenReady() 之前
process.on('uncaughtException', (error) => {
console.error('[Main Process Uncaught Exception]', error);
// 不调用 app.quit()，避免崩溃；可选择记录后 graceful exit
});
process.on('unhandledRejection', (reason, promise) => {
console.error('[Main Process Unhandled Rejection]', { reason, promise });
});? 提示：Electron 不会为主进程异常自动弹窗（除非显式调用 dialog.showErrorBox），但若未监听，进程可能意外退出。因此监听 + 日志是稳定性保障。
3. （进阶）禁用 Electron 内置错误对话框（v23+）
从 Electron 23 开始，可通过启动参数关闭调试相关弹窗（对生产环境更安全）：
// main.js
app.commandLine.appendSwitch('disable-features', 'OutOfProcessJavaScriptDebugging');
app.commandLine.appendSwitch('disable-gpu');
// ⚠️ 注意：--disable-logging 不推荐，会丢失关键日志同时，在创建 BrowserWindow 时明确禁用开发者工具（非调试环境）：
const win = new BrowserWindow({
webPreferences: {
devTools: false, // 生产环境务必设为 false
nodeIntegration: false,
contextIsolation: true,
}
});? 重要注意事项
- ❌ 不要依赖 setKiosk(true) 来屏蔽错误弹窗：它与错误处理逻辑完全无关；
- ✅ 始终在渲染进程启用 contextIsolation: true：这是现代 Electron 安全基线，也使 window.onerror 更可靠；
- ? 开发阶段请保留弹窗或使用 electron-debug 辅助定位，仅在打包后（process.env.NODE_ENV === 'production'）启用静默策略；
- ? 若使用打包工具（如 electron-builder），确保 nodeIntegration: false 且 preload 脚本正确注入错误监听逻辑。
✅ 总结
禁用 Electron 的 JS 错误弹窗不是“关闭某个开关”，而是建立健壮的错误防御体系：
① 渲染进程用 window.onerror + onunhandledrejection 拦截并返回 true；
② 主进程监听 uncaughtException 避免崩溃；
③ 结合生产环境配置（禁用 DevTools、合理设置 webPreferences）。
最终效果：错误静默发生、日志完整留存、应用稳定运行——这才是专业级 Electron 应用的容错标准。
