使用Node-API开发Node.js原生插件如何实现多实例全局数据共享？

静态变量是否安全 #

结论先行：如果满足以下两个条件，使用静态变量存储只读原生数据是完全安全的：

• 存储的内容是纯C++原生类型（非V8相关对象，不能是Napi::Value/napi_value及其派生类），V8对象与单个Worker的Isolate实例绑定，跨Isolate共享会直接引发崩溃。
• 保证静态变量的初始化是线程安全的，避免多个Worker同时加载模块时出现初始化竞态。

推荐实现方案 #

方案1：C++11 魔法静态变量（最简便） #

C++11及以上标准规定，函数内部的静态变量初始化是线程安全的，只会执行一次，非常适合只读全局数据的场景，不需要手动加锁：

#include <node_api.h>
#include <string>

// 全局只读数据获取函数
const std::string& GetSharedReadOnlyData() {
    // 此处初始化只会执行一次，多线程并发访问也不会有竞态
    static const std::string shared_data = [](){
        // 这里写你的数据初始化逻辑，比如读取配置文件、解析二进制资源等
        std::string init_data = "你的预加载只读数据";
        return init_data;
    }();
    return shared_data;
}

// 导出给JS层调用的接口示例
napi_value GetData(napi_env env, napi_callback_info info) {
    napi_value result;
    const auto& data = GetSharedReadOnlyData();
    napi_create_string_utf8(env, data.c_str(), data.size(), &result);
    return result;
}

该方案优势：实现简单，编译器保证初始化线程安全，只读场景下多线程读取无任何性能开销。

方案2：模块初始化时绑定只读导出属性 #

如果需要让JS层也能直接访问该只读数据，可以在每个Worker加载模块的初始化阶段，把静态原生数据转成V8对象，设置为不可写的导出属性即可：

#include <napi.h>

Napi::Object Init(Napi::Env env, Napi::Object exports) {
    // 每个Worker加载模块时执行，把共享的只读数据转成V8字符串，设置为不可写属性
    const auto& shared_data = GetSharedReadOnlyData();
    exports.DefineProperty(Napi::PropertyDescriptor::Value(
        "globalReadOnlyData",
        Napi::String::New(env, shared_data),
        napi_enumerable | napi_readonly // 不可修改
    ));
    exports.Set("getData", Napi::Function::New(env, GetData));
    return exports;
}

NODE_API_MODULE(your_module_name, Init)

注意事项 #

• 不要尝试存储任何V8相关对象到静态变量中，包括Napi::Object、Napi::Function等，这些对象只能在所属的Isolate（即所属Worker线程）中使用。
• Node-API提供的napi_set_instance_data/Napi::Env::SetInstanceData是单模块实例级别的存储，每个Worker加载模块时会有独立的实例数据，无法跨Worker共享，不适合该需求场景。
• 如果后续需要修改该全局数据，不能直接使用无锁的静态变量，需要补充读写锁保证线程安全。

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