node pkg打包serialport应用运行报错未找到对应平台原生构建

serialport 是依赖C++原生扩展的npm包，通过node-gyp-build加载对应平台、对应Node ABI版本的预编译/本地编译二进制文件。pkg默认不会自动把这类原生二进制文件打进虚拟snapshot文件系统，运行时找不到匹配的原生构建产物就会抛出对应错误。

• 先针对目标平台编译对应版本的原生模块：
  同平台编译直接执行命令：

  npm rebuild serialport --build-from-source
  

  提示：如果需要跨平台打包（比如在macOS/Windows上打Linux包），需要提前配置对应目标平台的交叉编译工具链，保证编译出来的.node文件和目标平台架构、libc版本匹配。没有交叉编译经验的话，最稳妥的方式是直接在和目标运行环境一致的系统里执行编译、打包操作，不需要额外配置环境，出错概率极低。
• 配置package.json的pkg字段，显式声明需要打包进产物的原生二进制文件路径，修改后的配置如下：

  {
    "name": "pkg",
    "version": "1.0.0",
    "dependencies": {
      "serialport": "^10.4.0"
    },
    "pkg": {
      "assets": [
        "node_modules/@serialport/bindings-cpp/prebuilds/**/*",
        "node_modules/@serialport/bindings-cpp/build/Release/*.node"
      ]
    }
  }
  

• 重新执行打包命令，保持目标Node版本和原生模块编译时的版本对齐：

  pkg app.js --target=node14-linux-x64
  

如果改完还是报错，优先检查两点：

• 打包进产物的.node文件是否和目标平台、Node ABI匹配：当前用的node14-linux-x64目标对应ABI版本为83，和报错信息里的abi=83完全匹配，只要原生模块是linux x64 glibc环境编译的就可以正常加载
• 不要把serialport安装成全局依赖，必须安装在当前项目的node_modules目录下，否则pkg找不到对应文件路径

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