Napi::Env是否可以在多线程环境下共享使用？

核心结论 #

不能直接在多线程场景共享、跨线程使用Napi::Env对象

原因解释 #

Napi::Env是Node-API封装V8引擎运行环境的上下文对象，本身绑定了V8的Isolate实例，而V8的Isolate、Handle等资源都属于线程绑定的设计，不支持跨线程访问：

• 所有Napi::Env相关的API调用都必须在Node.js主线程（也就是Env对应的Isolate所在的线程）执行，且调用时必须有活跃的v8::HandleScope存在
• 你遇到的报错就是因为在非Env所属线程尝试调用V8相关接口，此时该线程没有对应的HandleScope实例，V8无法创建句柄存储对象

报错中文翻译：

致命错误位于 v8::HandleScope::CreateHandle() #

无法在没有HandleScope的情况下创建句柄 #

正确实现方案 #

如果需要在多线程处理完任务后和Napi::Env交互，必须用Node-API提供的线程安全回调机制：

1. 主线程创建Napi::ThreadSafeFunction实例，绑定当前的Napi::Env和需要执行的回调函数
2. 将Napi::ThreadSafeFunction传递给工作线程，工作线程处理完异步任务后调用该实例的NonBlockingCall/BlockingCall方法提交回调
3. Node-API会自动将回调调度到Env所属的主线程执行，不需要手动跨线程传递Env

示例代码片段 #

// 主线程创建线程安全函数
Napi::ThreadSafeFunction tsfn = Napi::ThreadSafeFunction::New(
  env,
  Napi::Function::New(env, [](const Napi::CallbackInfo& info) {
    // 回调逻辑，此处可安全使用env
  }),
  "ThreadSafeCallback"
);

// 工作线程中使用
std::thread([tsfn]() mutable {
  // 执行耗时计算，全程不要直接操作env
  int result = 1 + 1;
  // 提交回调到主线程执行
  tsfn.NonBlockingCall([result](Napi::Env env, Napi::Function jsCallback) {
    // 此处传入的env属于主线程，可安全使用
    jsCallback.Call({Napi::Number::New(env, result)});
  });
  tsfn.Release();
}).detach();

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