Electron主进程使用typeof触发TypeError：无法赋值给只读exports属性

先定位核心问题根源 #

这个错误几乎都是模块导出方式不兼容，或是代码中误操作了只读的exports对象导致的——和你加的typeof验证本身无关，只是验证代码的引入刚好触发了模块系统的冲突。

分场景给出解决方案 #

场景1：混用ES模块与CommonJS导出语法

如果你的项目package.json里设置了"type": "module"（开启ES模块模式），但抽离的IPC处理模块用了CommonJS的module.exports导出，就会触发这个错误——因为ES模块环境中module.exports是只读属性，无法直接赋值。

修复方式：统一用ES模块语法导出导入

// ipcHandlers.js（ES模块写法）
export default function setupIpcHandlers(ipcMain) {
  // 你的验证逻辑示例
  const validatePayload = (payload) => {
    if (typeof payload !== 'object' || payload === null) {
      throw new Error('传入参数必须是对象');
    }
  };

  // IPC事件处理
  ipcMain.on('submit-data', (event, payload) => {
    try {
      validatePayload(payload);
      // 业务逻辑处理
      event.reply('submit-success', '数据验证通过');
    } catch (err) {
      event.reply('submit-error', err.message);
    }
  });
}

然后在main.js中用import引入：

import { app, ipcMain } from 'electron';
import setupIpcHandlers from './ipcHandlers.js';

app.whenReady().then(() => {
  setupIpcHandlers(ipcMain);
  // 其他主进程逻辑
});

场景2：CommonJS模式下错误使用exports导出

如果项目是默认的CommonJS模式（没有"type": "module"），但你在模块里写了exports = setupIpcHandlers而非module.exports = setupIpcHandlers，也会触发错误——因为exports只是module.exports的引用，直接给exports赋值会断开关联，Electron的CommonJS环境会限制这种操作。

修复方式：用module.exports正确导出函数

// ipcHandlers.js（CommonJS写法）
function setupIpcHandlers(ipcMain) {
  // 验证ipcMain实例有效性
  if (typeof ipcMain !== 'object' || ipcMain === null) {
    throw new Error('必须传入有效的ipcMain实例');
  }

  // 你的IPC事件与验证逻辑
  ipcMain.on('get-user-info', (event, args) => {
    if (typeof args !== 'object' || args === null) {
      event.reply('get-user-error', '参数格式错误');
      return;
    }
    // 业务逻辑
  });
}

// 正确导出方式
module.exports = setupIpcHandlers;

在main.js中正常用require引入即可：

const { app, ipcMain } = require('electron');
const setupIpcHandlers = require('./ipcHandlers');

app.whenReady().then(() => {
  setupIpcHandlers(ipcMain);
});

场景3：验证代码误操作了exports变量

如果你的验证函数里不小心把参数命名为exports，或是误修改了模块顶层的exports对象，也会触发只读属性错误。比如：

// 错误示例：变量名冲突
function validate(exports) {
  // 这里的exports是局部参数，但如果误写成全局exports赋值就会出错
  if (typeof exports !== 'object') {
    exports = {}; // 若此处是模块顶层的exports，就会触发只读错误
  }
}

修复方式：修改参数名，避免和模块导出变量冲突，确保验证逻辑只处理业务对象，不碰模块导出相关变量。

额外排查：Electron版本兼容性 #

部分旧版本Electron在模块导出处理上存在bug，若上述方案无效，可以尝试升级到最新稳定版（比如v20+），大概率能解决问题。

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