Electron中用koffi对接C++ DLL的内存分配与指针处理问题

我正在开发对接C++ DLL管理USB设备的Electron应用，因node-ffi-napi兼容性问题转用Koffi，核心是调用getStLinkList函数——该函数通过malloc分配设备结构体数组并返回指针，目前遇到指针传递、内存访问和内存管理的问题，且Koffi调用时返回0（C/C++环境中正常返回1）。以下是针对性解决方案：

1. 正确分配指针的指针供DLL写入 #

Koffi中要传递可被DLL修改的指针指针，需使用输出参数或预先分配指针变量：

方法一：用koffi.out声明参数类型 #

const koffi = require('koffi');
const lib = koffi.load('your-dll-path.dll');

// 定义与DLL一致的结构体（需替换为实际字段）
const DebugConnectParameters = koffi.struct('debugConnectParameters', {
    id: 'uint32_t',
    deviceName: koffi.array('char', 256),
    // 补充其他结构体成员...
});

// 声明函数时，将第一个参数指定为输出类型（指向结构体指针的指针）
const getStLinkList = lib.func('int', [koffi.out(koffi.pointer(DebugConnectParameters)), 'int']);

// 调用函数
let stLinkListPtr = null;
const shared = 0;
const numberOfDevices = getStLinkList(stLinkListPtr, shared);

方法二：手动分配指针内存 #

// 分配一块指针大小的内存，用于存储DLL返回的结构体数组指针
const stLinkListPtrPtr = koffi.alloc('pointer', null);

// 调用函数时传递该内存地址
const numberOfDevices = getStLinkList(stLinkListPtrPtr, shared);

// 读取DLL写入的结构体数组指针
const stLinkListPtr = koffi.read(stLinkListPtrPtr, 'pointer');

2. 访问并遍历DLL返回的设备数据 #

拿到结构体数组指针后，通过内存地址偏移逐个读取元素：

if (numberOfDevices > 0 && stLinkListPtr) {
    const devices = [];
    const structSize = koffi.sizeof(DebugConnectParameters);
    
    for (let i = 0; i < numberOfDevices; i++) {
        // 计算第i个结构体的内存地址：数组指针 + 索引*结构体大小
        const structAddr = koffi.add(stLinkListPtr, i * structSize);
        // 读取结构体数据
        const device = koffi.read(structAddr, DebugConnectParameters);
        // 转换char数组为字符串
        device.deviceName = koffi.toString(device.deviceName);
        devices.push(device);
    }
    console.log('检测到设备：', devices);
}

注意：必须完全匹配DLL中debugConnectParameters的结构体定义（字段类型、顺序、对齐方式），否则会出现内存访问错误。

3. DLL分配内存的管理最佳实践 #

• 优先调用DLL提供的释放函数：绝大多数C++ DLL会配套内存释放接口（比如freeStLinkList），必须用它释放DLL分配的内存：

  // 假设DLL提供释放函数
  const freeStLinkList = lib.func('void', [koffi.pointer(DebugConnectParameters)]);
  // 使用完毕后释放
  if (stLinkListPtr) {
      freeStLinkList(stLinkListPtr);
  }
  

• 禁止直接使用Node.js的内存释放方法：DLL的堆内存与Node.js的堆内存不共享，直接调用Node.js的free会导致崩溃。
• 封装内存管理逻辑：将设备获取和内存释放封装在同一个函数中，确保资源被正确回收：

  function getStLinkDevices(shared = 0) {
      let stLinkListPtr = null;
      try {
          const numberOfDevices = getStLinkList(stLinkListPtr, shared);
          const devices = [];
          if (numberOfDevices > 0 && stLinkListPtr) {
              // 读取设备数据逻辑...
          }
          return devices;
      } finally {
          if (stLinkListPtr) {
              freeStLinkList(stLinkListPtr);
          }
      }
  }
  

针对更新内容：调用返回0的问题排查 #

在C/C++中正常返回1，但Koffi调用返回0，按以下顺序排查：

1. 位数匹配：确保Electron的位数（32/64位）与DLL完全一致，比如64位DLL必须搭配64位Electron。
2. 依赖库加载：检查DLL依赖的驱动库（如ST-LINK相关组件）是否在Electron运行目录或系统PATH中。
3. 权限问题：USB设备访问需要管理员权限，尝试以管理员身份启动Electron应用。
4. 函数声明错误：核对Koffi中函数的返回值、参数类型是否与DLL完全一致，比如shared参数是否应为bool而非int。
5. Electron沙箱限制：若开启沙箱，可能限制USB设备访问，可在窗口配置中关闭：

   const mainWindow = new BrowserWindow({
       webPreferences: {
           sandbox: false,
           nodeIntegration: true,
           contextIsolation: false
       }
   });
   

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