从NodeJS调用含const int16_t*参数的C++函数出现类型未绑定/段错误如何解决

你之前的调用出错核心是两类问题：

1. nbind 报类型未绑定是因为 C++ 侧没有完成自定义结构体、函数的绑定注册，无法直接在 JS 侧调用
2. ffi-napi 段错误是因为直接传递 Int16Array 对象不符合指针传参要求，C++ 侧拿到了非法内存地址导致访问越界

ffi-napi 快速实现方案 #

第一步：安装依赖 #

npm install ffi-napi ref-napi ref-struct-napi

第二步：定义C++类型映射与库绑定 #

const ffi = require('ffi-napi')
const ref = require('ref-napi')
const Struct = require('ref-struct-napi')

// 映射C++的struct foo类型
const Foo = Struct({
  data: ref.refType(ref.types.uint8),
  dataSize: ref.types.int
})
const FooPtr = ref.refType(Foo)

// 加载动态库，绑定导出函数签名
// 注意替换下面的动态库路径为你实际的文件路径（Windows是dll，Linux是so，Mac是dylib）
const lib = ffi.Library('./你的动态库文件名', {
  ExtractBar: [FooPtr, [ref.refType(ref.types.int16)]]
})

第三步：构造参数并调用 #

// 1. 构造符合要求的int16数组，长度需要匹配C++侧ExtractBar的预期长度
const int16Arr = new Int16Array(5) // 示例长度为5，按实际需求修改
int16Arr.fill(0) // 填充数值，可根据业务需求修改赋值逻辑

// 2. 取Int16Array底层的Buffer作为指针传参，ffi-napi会自动取Buffer的首地址传入C++
const paramBuffer = Buffer.from(int16Arr.buffer)

// 3. 调用函数
const fooResultPtr = lib.ExtractBar(paramBuffer)

// 4. 解析返回的结构体数据
const fooResult = fooResultPtr.deref()
// 把C++侧的uint8_t*数据转成JS侧可操作的Uint8Array
const resultData = new Uint8Array(fooResult.data.readPointer(0, fooResult.dataSize))

// *重要：释放C++侧申请的内存，避免内存泄漏
// 如果C++侧提供了专门的释放函数就调用释放函数，否则用ref.free手动释放
ref.free(fooResult.data)
ref.free(fooResultPtr)

nbind 报错修复说明 #

如果要继续使用nbind，需要在C++侧补充绑定逻辑：

• 用nbind的宏注册struct foo结构体
• 注册ExtractBar函数的导出声明，完成类型绑定后JS侧才能正常调用

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