MacOS环境下使用ffi-napi加载.dll文件失败求助

问题根源 #

你在macOS系统上尝试加载Windows专属的.dll动态库，而ffi-napi会根据当前操作系统自动添加对应平台的后缀（macOS默认加.dylib），导致系统找不到对应文件；同时，.dll格式本身不被macOS支持，即使强制指定路径也无法正常运行。

具体解决方案 #

• 编译对应平台的动态库
  .dll是Windows平台的动态库格式，macOS无法直接识别运行。需要将你的testLibrary代码重新编译为macOS兼容的.dylib格式，之后用以下代码加载：

  const ffi = require('ffi-napi');
  const path = require('path');
  
  const file = path.join(__dirname, 'testLibrary');
  const pos = ffi.Library(file, {
    testFunction: ['void', ['int']],
  });
  

  此时ffi-napi会自动添加.dylib后缀，匹配你的macOS库文件。

• 强制指定完整文件名（仅适用于特殊场景）
  如果你确实需要加载带有.dll后缀的文件（比如特殊打包场景，但macOS本身无法解析该格式），可以通过设置suffix选项禁用自动添加后缀：

  const ffi = require('ffi-napi');
  const path = require('path');
  
  const file = path.join(__dirname, 'testLibrary.dll');
  const pos = ffi.Library(file, {
    testFunction: ['void', ['int']],
  }, { suffix: '' }); // 禁用自动平台后缀
  

  注意：此方法仅解决路径匹配问题，macOS仍无法执行.dll里的代码，最终还是会报错。

• 跨平台兼容加载
  若要让代码支持多平台，可以根据操作系统自动选择对应格式的库文件：

  const ffi = require('ffi-napi');
  const path = require('path');
  const os = require('os');
  
  let libPath;
  switch(os.platform()) {
    case 'win32':
      libPath = path.join(__dirname, 'testLibrary.dll');
      break;
    case 'darwin':
      libPath = path.join(__dirname, 'testLibrary.dylib');
      break;
    case 'linux':
      libPath = path.join(__dirname, 'libtestLibrary.so');
      break;
    default:
      throw new Error('当前平台不支持');
  }
  
  const pos = ffi.Library(libPath, {
    testFunction: ['void', ['int']],
  }, { suffix: '' });
  

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