Electron中node-ffi-napi报错无匹配原生构建，如何排查问题类型

报错信息 #

Error: No native build was found for platform=win32 arch=x64 runtime=electron abi=89 uv=1 libc=glibc node=14.16.0 electron=13.6.9 webpack=true
loaded from: C:\Coding\cas_utils
at Function.load.path (webpack:///./node_modules/node-gyp-build/index.js?:60:9)
at load (webpack:///./node_modules/node-gyp-build/index.js?:22:30)
at eval (webpack:///./node_modules/ref-napi/lib/ref.js?:8:111)
at Object../node_modules/ref-napi/lib/ref.js (C:\Coding\cas_utils\dist_electron\index.js:1806:1)
at webpack_require (C:\Coding\cas_utils\dist_electron\index.js:20:30)
at eval (webpack:///./node_modules/ffi-napi/lib/ffi.js?:7:13)
at Object../node_modules/ffi-napi/lib/ffi.js (C:\Coding\cas_utils\dist_electron\index.js:790:1)
at webpack_require (C:\Coding\cas_utils\dist_electron\index.js:20:30)
at eval (webpack:///./src/CAS_DLL.js?:1:11)
at Object../src/CAS_DLL.js (C:\Coding\cas_utils\dist_electron\index.js:2096:1)

当前代码与配置 #

CAS_DLL.js代码 #

var ffi = require("ffi-napi");
var libloc = "\CAS DLL\AlfaCalcInterface.dll";
const ces = ffi.Library(libloc, {
  'SetDatabaseDir': ['int', [ 'char *']],
});

vue.config.js配置 #

const { defineConfig } = require('@vue/cli-service')
const nodeExternals = require('webpack-node-externals');

module.exports = defineConfig({
  transpileDependencies: true,
  configureWebpack: {
    externals: [nodeExternals({
      allowlist: [/^(?!(^(ffi-napi)$)).*$/i]
    })],
  }
})

当前环境：Node 16.14.2，npm 8.5.0，Electron 13.6.9

判断方法 #

1. 从报错栈直接定位 #

当前报错起始于node-gyp-build/index.js，明确提示No native build was found，且触发点是加载ref-napi（ffi-napi的依赖库）阶段，尚未执行到加载自定义DLL的代码。这说明大概率是ffi-napi及其依赖缺少适配当前Electron环境的二进制文件，而非自定义DLL的加载问题。

2. 验证ffi-napi本身是否能初始化 #

写一段极简测试代码，跳过自定义DLL加载，仅初始化ffi-napi：

// test-ffi.js
const ffi = require('ffi-napi');
console.log('ffi-napi initialized successfully');

在Electron环境中运行这段代码：

• 如果仍报相同的No native build was found错误，可确认是ffi-napi的二进制适配问题；
• 如果代码正常输出，说明ffi-napi本身没问题，再排查自定义DLL的加载问题。

3. 检查ffi-napi的二进制适配性 #

• 错误信息中runtime=electron abi=89对应Electron 13.x的ABI版本，你本地Node版本是16，但Electron内置的Node是14.16.0，二者ABI版本不兼容；
• 进入node_modules/ref-napi和node_modules/ffi-napi目录，查看是否存在prebuilds/win32-x64/electron-89（或类似命名）的二进制文件。如果没有，说明缺少适配当前Electron版本的预编译二进制。

4. 排查自定义DLL加载问题（若ffi-napi正常） #

• 修正路径：当前libloc的反斜杠未转义，会导致路径解析错误，应改为"./CAS DLL/AlfaCalcInterface.dll"或"CAS DLL\\AlfaCalcInterface.dll"；
• 使用绝对路径测试：直接传入DLL的完整绝对路径，比如"C:\\Coding\\cas_utils\\CAS DLL\\AlfaCalcInterface.dll"，确认文件是否存在、是否能被加载。

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