Electron项目中Napi::Function::New调用触发内存访问错误排查求助

详细调试步骤（针对内存访问类低级错误） #

1. 生成带调试符号的插件构建 #

修改package.json中的构建脚本，生成包含完整调试信息的插件版本：

"build-native": "cmake-js rebuild --runtime=electron --runtime-version=40.6.1 --debug"

执行npm run build-native后，调整main.js中的插件路径指向Debug版本：

const addonPath = path.join(__dirname, '../build/Debug/my_native_addon.node');

2. 使用系统调试器定位崩溃点 #

Windows（WinDbg）

• 打开WinDbg，附加到electron.exe进程
• 输入命令sxe ld:my_native_addon.node，设置插件加载时触发断点
• 按F5继续执行，插件加载完成后输入bp addon!Init给Init函数设置断点
• 单步执行（F10）到Napi::Function::New(env, HelloWorld)，观察内存与寄存器状态，定位崩溃根源

macOS/Linux（lldb）

• 终端执行lldb -- electron electron/main.js启动调试会话
• 输入breakpoint set --name Init给Init函数设置断点
• 输入run启动进程，触发断点后用step命令单步执行代码
• 崩溃时输入bt打印调用栈，获取具体错误位置与调用链路

3. 验证ABI兼容性 #

• 执行electron -v确认版本为40.6.1，与build-native脚本中的--runtime-version完全一致
• 清理旧构建产物：rm -rf build，重新执行npm run build-native

潜在代码/配置错误排查 #

CMakeLists路径匹配问题 #

检查CMAKE_JS_SRC配置的文件路径是否与实际文件位置一致：

set(CMAKE_JS_SRC "native/addon.cpp")

如果你的addon.cpp不在native目录下，需修正路径，否则构建出的插件可能存在代码缺失，直接触发内存访问错误。

异常处理说明 #

你开启的NAPI_CPP_EXCEPTIONS仅能捕获Node-API层的C异常，而内存访问错误属于操作系统级别的信号（如SIGSEGV），无法被C try/catch捕获，这也是你的后续日志无法输出的原因。

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