Electron非聚焦窗口拖拽文件异常问题求助

问题根因 #

你遇到的TypeError: Cannot read properties of null (reading 'webContents')，本质是依赖BrowserWindow.getFocusedWindow()获取窗口实例的逻辑失效——当快速拖拽文件到非聚焦窗口时，系统焦点还停留在桌面/Finder，该方法会返回null。

修复方案 #

无需修改渲染进程逻辑（保持进程隔离），只需在主进程的IPC处理中，通过IPC事件对象直接绑定发起请求的渲染进程，而非依赖窗口焦点：

主进程代码修改 #

调整open-file的IPC处理器，用event.sender获取当前请求对应的webContents，再反向关联到窗口：

// main.js
ipcMain.handle('open-file', async (event, filePath) => {
  // 从IPC事件中拿到发起请求的渲染进程webContents
  const targetWebContents = event.sender;
  const targetWindow = BrowserWindow.fromWebContents(targetWebContents);

  if (!targetWindow) {
    throw new Error('无法定位请求对应的窗口');
  }

  // 原文件读取逻辑保留
  try {
    const content = await fs.promises.readFile(filePath, 'utf8');
    return { success: true, content };
  } catch (err) {
    return { success: false, error: err.message };
  }
});

逻辑说明 #

• event.sender是触发IPC调用的渲染进程webContents实例，无论窗口是否聚焦，这个引用始终有效，完全不受系统焦点状态影响
• BrowserWindow.fromWebContents()通过webContents精准找到所属窗口，彻底规避了焦点依赖问题
• 渲染进程无需感知任何系统窗口状态，只需正常通过preload桥接发起请求，完美维持主/渲染进程隔离要求

额外提示 #

• 沙箱模式下确保preload.js仅暴露必要的IPC桥接方法，不传递任何窗口相关的敏感对象
• MacOS下拖拽到非聚焦窗口时，系统会延迟激活窗口，但IPC请求发起时event.sender已经绑定到目标窗口的渲染进程，不会出现null引用问题

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