Electron中使用pdf.js时无法解析fs/zlib等Node原生模块的解决方法

1. 适配打包工具（以Webpack为例） #

你使用Webpack打包渲染进程时，Webpack默认会将Node原生模块视为需要打包的资源，但这些模块是Electron内置的，无需打包。需在Webpack配置中添加externals，告知Webpack直接使用Electron提供的原生模块：

方式一：指定单个模块 #

在webpack.renderer.config.js中添加：

module.exports = {
  // 其他配置...
  externals: {
    'fs': 'commonjs fs',
    'zlib': 'commonjs zlib'
  }
};

方式二：自动排除所有Node核心模块 #

先安装依赖：

npm install webpack-node-externals --save-dev

然后在配置中引入并使用：

const nodeExternals = require('webpack-node-externals');

module.exports = {
  // 其他配置...
  externals: [nodeExternals()]
};

2. 调整Electron窗口的WebPreferences配置 #

仅开启nodeIntegration可能不够，还需处理上下文隔离（contextIsolation）：

方案A：关闭上下文隔离（快速但有安全风险） #

开发环境或对安全要求不高时，可关闭上下文隔离，让渲染进程直接访问Node模块：

webPreferences: {
  preload: MAIN_WINDOW_PRELOAD_WEBPACK_ENTRY,
  nodeIntegration: true,
  contextIsolation: false, // 新增配置
  enableRemoteModule: true // 需使用remote模块时添加
}

方案B：使用Preload脚本安全暴露API（推荐） #

保持上下文隔离开启（默认开启），通过preload脚本向渲染进程暴露所需的原生模块方法，避免全量暴露的安全问题：
在preload脚本中：

const { contextBridge } = require('electron');
const fs = require('fs');
const zlib = require('zlib');

// 仅暴露业务需要的方法，而非整个模块
contextBridge.exposeInMainWorld('safeNodeAPI', {
  fs: {
    readFile: fs.readFile,
    writeFile: fs.writeFile
  },
  zlib: {
    createGzip: zlib.createGzip,
    gunzip: zlib.gunzip
  }
});

渲染进程中通过window.safeNodeAPI.fs调用对应方法，窗口配置保持：

webPreferences: {
  preload: MAIN_WINDOW_PRELOAD_WEBPACK_ENTRY,
  nodeIntegration: false, // 建议关闭以提升安全性
  contextIsolation: true // 默认开启，无需额外设置
}

3. 确认pdf.js-extract的运行环境 #

pdf.js-extract这类库可能区分浏览器和Node环境，优先在主进程中使用它——主进程天然支持Node模块，无需额外配置，直接require即可。若必须在渲染进程使用，确保打包工具和窗口配置调整完毕。

4. 清理依赖缓存 #

若配置后仍报错，可能是依赖安装不完整，执行以下命令重置依赖：

rm -rf node_modules package-lock.json
npm install

之后重新打包启动应用。

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