使用node-addon-api从char向量创建Buffer内容异常，如何修复？

这个问题我之前也踩过坑，核心原因是局部std::vector<char>的生命周期和Node.js Buffer的内存管理不匹配，我来拆解清楚原因和解决办法：

问题根源 #

在GetBuffer函数里，你定义的std::vector<char> v是局部变量——当函数执行完毕返回Buffer后，这个vector会被立即销毁，它所管理的内存也会被系统回收。而你用v.data()传给Napi::Buffer::New时，Buffer只是持有了这块已释放内存的指针，后续JavaScript访问Buffer时，读到的都是已经被回收的垃圾内存，所以每次输出的结果都随机变化。

正确实现方式 #

有两种常用的解决思路，你可以根据数据规模选择：

1. 拷贝vector数据到Buffer（简单直接，适合小数据） #

让Node.js的Buffer自己分配独立内存，然后把vector的内容拷贝进去，这样Buffer的内存不会受局部vector销毁的影响：

#include <napi.h>
#include <algorithm> // 用于std::copy

Napi::Value GetBuffer(const Napi::CallbackInfo& info) {
    Napi::Env env = info.Env();
    std::vector<char> v{0x10, 0x11, 0x12};
    
    // 创建指定大小的Buffer，Node.js会负责管理这块内存
    Napi::Buffer<char> buffer = Napi::Buffer<char>::New(env, v.size());
    // 把vector的数据拷贝到Buffer的内存中
    std::copy(v.begin(), v.end(), buffer.Data());
    
    return buffer;
}

Napi::Object Init(Napi::Env env, Napi::Object exports) {
    exports.Set(Napi::String::New(env, "getBuffer"), Napi::Function::New(env, GetBuffer));
    return exports;
}

NODE_API_MODULE(addon, Init);

2. 让Buffer接管vector的内存（零拷贝，适合大数据） #

如果你的vector数据量很大，不想做内存拷贝，可以让Buffer接管vector的内存，同时指定一个销毁回调，当Buffer被Node.js的GC回收时，自动销毁vector：

#include <napi.h>

Napi::Value GetBuffer(const Napi::CallbackInfo& info) {
    Napi::Env env = info.Env();
    // 动态分配vector，避免局部变量销毁导致内存释放
    std::vector<char>* v = new std::vector<char>{0x10, 0x11, 0x12};
    
    // 创建Buffer，传入自定义销毁回调，负责释放vector
    return Napi::Buffer<char>::New(
        env,
        v->data(),
        v->size(),
        [](Napi::Env /*env*/, char* /*data*/, void* hint) {
            // 从hint中取出vector指针并释放
            delete static_cast<std::vector<char>*>(hint);
        },
        v // 把vector指针作为hint传递给销毁回调
    );
}

Napi::Object Init(Napi::Env env, Napi::Object exports) {
    exports.Set(Napi::String::New(env, "getBuffer"), Napi::Function::New(env, GetBuffer));
    return exports;
}

NODE_API_MODULE(addon, Init);

验证结果 #

修改C++代码重新编译后，运行你的JavaScript代码：

const addon = require('./build/Release/addon');
const buffer = addon.getBuffer();
console.log(buffer.toString("hex")); // 现在会稳定输出101112

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