Electron主进程菜单触发IPC消息发送到渲染进程无响应如何解决

核心原因 #

你遇到的问题核心是上下文隔离下直接暴露ipcRenderer原生方法会导致方法上下文丢失，同时可能伴随配置、监听时机的隐性问题，按以下步骤修正即可：

1. 修正预加载脚本（Preload）写法 #

不要直接把ipcRenderer.on赋值给暴露对象，需要做一层封装，同时添加通道白名单保证安全性，还可以补充移除监听的方法避免内存泄漏：

import { contextBridge, ipcRenderer } from "electron";

contextBridge.exposeInMainWorld("ipc", {
  on: (channel, callback) => {
    // 只允许监听指定的合法通道，避免安全风险
    const allowedChannels = ['save'];
    if (allowedChannels.includes(channel)) {
      ipcRenderer.on(channel, callback);
    }
  },
  off: (channel, callback) => {
    const allowedChannels = ['save'];
    if (allowedChannels.includes(channel)) {
      ipcRenderer.removeListener(channel, callback);
    }
  }
});

2. 确认BrowserWindow配置正确 #

检查主进程创建窗口的代码，确保preload路径配置正确，没有错误关闭上下文隔离：

const { BrowserWindow } = require('electron');
const path = require('path');

const mainWindow = new BrowserWindow({
  width: 800,
  height: 600,
  webPreferences: {
    // 这里的路径必须和你实际的preload文件路径匹配，用path.join避免相对路径错误
    preload: path.join(__dirname, 'preload.js'),
    // Electron 12+ 默认开启contextIsolation，不要手动设为false
    contextIsolation: true,
    // 不要开启nodeIntegration，存在安全风险
    nodeIntegration: false
  }
})

3. 调整渲染进程监听时机 #

确保渲染进程绑定监听时，预加载脚本注入的window.ipc已经完成挂载，建议把监听逻辑放在DOM加载完成后执行：

document.addEventListener('DOMContentLoaded', () => {
  window.ipc.on("save", () => {
    console.log("save");
  })
})

4. （可选）优化主进程事件发送逻辑 #

避免窗口未加载完成时发送事件导致丢失，可给发送逻辑增加加载状态判断：

const menuTemplate = [
    {
        label: "File",
        submenu: [
            {
                label: "Save",
                accelerator: "Ctrl+S",
                click: () => {
                    const focusedWin = BrowserWindow.getFocusedWindow();
                    if (!focusedWin) return;
                    // 页面加载完成后再发送事件
                    if (focusedWin.webContents.isLoading()) {
                      focusedWin.webContents.once('did-finish-load', () => {
                        focusedWin.webContents.send("save");
                      })
                    } else {
                      focusedWin.webContents.send("save");
                    }
                }
            },
        ]
    },
]

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