Electron中C++ Node Addon无法用外部数据初始化ArrayBuffer的问题

错误原因 #

Electron默认启用V8沙箱机制，该机制要求ArrayBuffer的底层内存必须在沙箱专属的地址空间内分配。你用new char[]手动分配的内存不在这个空间范围内，因此触发V8的致命错误。

解决方案 #

方案一：使用Napi官方分配器分配内存（推荐） #

通过Napi提供的ArrayBuffer::Allocator来分配内存，确保内存处于沙箱地址空间内，同时配置回调函数在ArrayBuffer被垃圾回收时自动释放内存。修改后的addon.cc代码如下：

Napi::ArrayBuffer loadImage(const Napi::CallbackInfo& info) {
  // 以二进制模式打开图片，避免Windows下的格式转换问题
  std::ifstream image("img.jpg", std::ios::binary);
  if (!image.is_open()) {
    throw Napi::Error::New(info.Env(), "无法打开图片文件");
  }

  // 获取图片文件大小
  image.seekg(0, image.end);
  size_t bufferSize = image.tellg();
  image.seekg(0, image.beg);

  // 获取当前环境的ArrayBuffer分配器
  Napi::ArrayBuffer::Allocator* allocator = info.Env().GetArrayBufferAllocator();
  // 分配符合沙箱要求的内存
  void* data = allocator->Allocate(bufferSize);
  if (!data) {
    throw Napi::Error::New(info.Env(), "内存分配失败");
  }

  // 将图片数据读取到分配的内存中
  image.read(static_cast<char*>(data), bufferSize);
  if (!image) {
    // 读取失败时释放已分配的内存，避免泄漏
    allocator->Free(data);
    throw Napi::Error::New(info.Env(), "图片数据读取失败");
  }

  // 创建ArrayBuffer，并设置内存释放回调
  return Napi::ArrayBuffer::New(
    info.Env(), 
    data, 
    bufferSize, 
    [](Napi::Env env, void* data, size_t) {
      env.GetArrayBufferAllocator()->Free(data);
    }
  );
}

关键改进点：

• 用size_t存储文件大小，避免int的范围限制
• 以二进制模式打开文件，保证数据完整性
• 使用沙箱兼容的分配器分配内存
• 添加错误处理和内存泄漏防护
• 配置GC回调自动释放内存

方案二：禁用V8沙箱（不推荐） #

如果不需要沙箱的安全隔离，可以在创建BrowserWindow时禁用沙箱，这样手动分配的内存就能被V8识别。修改addon.js中的BrowserWindow配置：

const createWindow = () => {
    const win = new BrowserWindow({
        width: 800, 
        height: 600, 
        webPreferences: {
            preload: path.join(__dirname, 'preload.js'),
            sandbox: false, // 禁用沙箱
            contextIsolation: true
        }
    })

    win.loadFile("test.html")
}

注意：禁用沙箱会降低Electron应用的安全性，仅建议在测试环境或无安全风险的场景使用。

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