如何解决Electron报错Buffer is not defined的问题

问题根因 #

该报错本质是渲染进程运行上下文中没有挂载Node.js的Buffer全局对象：Electron 12+ 版本默认开启contextIsolation，仅配置nodeIntegration: true不会将Node API注入到渲染层业务上下文；同时Ember默认按浏览器环境构建产物，不会自动注入Node内置模块的polyfill，会导致依赖Buffer的第三方包无法找到对应对象。

可落地解决步骤 #

• 优先通过预加载脚本暴露Buffer，不推荐直接关闭上下文隔离（存在安全风险）
  在Electron主进程的BrowserWindow初始化配置中指定preload脚本路径，保持安全配置开启：

  // Electron主进程代码
  const path = require('path')
  const mainWindow = new BrowserWindow({
    width: 1200,
    height: 800,
    webPreferences: {
      preload: path.join(__dirname, 'preload.js'),
      nodeIntegration: false,
      contextIsolation: true,
      sandbox: false
    }
  })
  

  编写preload脚本，将Buffer挂载到window全局供渲染层调用：

  // preload.js
  const { Buffer } = require('node:buffer')
  window.Buffer = Buffer
  

• 处理Ember构建阶段的Buffer polyfill注入
  Ember CLI构建时默认不会自动补全Node内置模块的浏览器端实现，需要手动安装依赖并配置构建规则：
  1. 安装polyfill依赖

  npm install buffer --save-dev
  

  2. 修改ember-cli-build.js配置，通过autoImport的webpack配置注入全局Buffer：

  // ember-cli-build.js
  const EmberApp = require('ember-cli/lib/broccoli/ember-app');
  const webpack = require('webpack');
  
  module.exports = function(defaults) {
    let app = new EmberApp(defaults, {
      autoImport: {
        webpack: {
          resolve: {
            fallback: {
              buffer: require.resolve('buffer/'),
            },
          },
          plugins: [
            new webpack.ProvidePlugin({
              Buffer: ['buffer', 'Buffer'],
            }),
          ],
        },
      }
    });
    return app.toTree();
  };
  

  如果项目使用的ember-auto-import版本过低不支持自定义webpack插件，可以直接在Ember入口文件app/app.js顶部手动挂载全局Buffer：

  // app/app.js
  import { Buffer } from 'buffer';
  window.Buffer = Buffer;
  // 其余原有入口代码不变
  

• 重启验证
  重启Electron应用后，在渲染进程开发者工具控制台输入Buffer，能正常打印出Buffer构造函数即为配置生效，此时eosjs-ecc可正常加载运行。

避坑说明 #

• 不要为了快速解决问题直接关闭contextIsolation，该配置会让渲染层获得全量Node API访问权限，加载第三方页面/资源时存在极高的远程代码执行风险，通过preload按需暴露API是Electron官方推荐的安全实践。
• 仅配置nodeIntegration: true仍报错的核心原因是Ember构建阶段会对依赖做浏览器环境适配，未声明polyfill的情况下会把Node原生buffer依赖从构建产物中剔除，必须补充构建阶段的polyfill配置才能从根本上解决问题。

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