使用pkg打包含edge-js的Node.js程序为exe时出现内存损坏错误

DevOps 小满

2026-7-9

解决edge-js + pkg打包后出现内存访问错误的问题

问题分析

这个错误的核心原因是pkg打包时未正确处理edge-js依赖的原生二进制文件，或者edge-js的V8同步上下文在打包后的独立环境中初始化失败——毕竟edge-js依赖.NET Runtime和特定架构的Node.js原生组件，pkg默认的打包逻辑可能漏处理这些依赖。

严格匹配pkg的target参数
edge-js的二进制文件和Node.js版本、系统架构强绑定，打包时必须指定和当前运行环境完全一致的target。比如你用64位Node.js 16.x开发，打包命令要写：
```
pkg --target node16-win-x64 index.js
```
不要用默认target，否则容易出现架构/版本不匹配导致的内存访问异常。
手动补充edge-js的原生依赖文件
打包完成后，找到node_modules/edge-js/lib/native/win32/x64（根据你的系统架构调整路径）下的所有.dll文件，复制到生成的.exe同目录下。pkg有时会遗漏这些非JS的原生依赖，手动补充后再运行程序。
调整edge-js版本至兼容版本
部分edge-js版本和pkg存在兼容性问题，建议切换到与当前Node.js版本匹配的稳定版：比如Node.js 16对应edge-js@16.0.0，Node.js 18对应edge-js@18.0.0，安装后重新打包测试。
通过pkg配置强制包含原生文件
在项目根目录的package.json中添加pkg配置段，明确指定要打包的edge-js原生文件：
```
{
  "pkg": {
    "assets": [
      "node_modules/edge-js/lib/native/**/*"
    ]
  }
}
```
这样pkg会强制打包所有edge-js的原生组件，避免依赖缺失。