Electron打包后跨Windows版本启动报错：DLL初始化例程失败

问题描述 #

我开发的Electron程序在本地Windows 11环境运行正常，但通过electron-builder --win portable命令打包为便携版后，在Windows 10电脑上启动时出现「a dynamic link library (dll) initialization routine failed」错误。

相关package.json配置 #

{
    "scripts": {
        "build:renderer": "webpack --config ./client/webpack.config.renderer.js",
        "build:main": "tsc --project ./client/tsconfig.json",
        "build": "npm run build:main && npm run build:renderer",
        "build:addon:x86": "(cmake-js -G \"Visual Studio 16 2019\" -A Win32 -O build_Win32)",
        "build:addon:x64": "(cmake-js -G \"Visual Studio 16 2019\" -A x64 -O build_x64)",
        "start": "electron . --enable-logging",
        "copy_binary": "copy_binary.bat",
        "dist": "electron-builder --win portable"
    },
    "devDependencies": {
        "cmake-js": "^7.0.0",
        "electron-rebuild": "^3.2.7",
        "ts-loader": "^9.4.1",
        "typescript": "^3.1.0",
        "webpack": "^5.74.0",
        "electron": "16.0.10",
        "webpack-cli": "^4.10.0"
    },
    "dependencies": {
        "node-addon-api": "^4.1.0"
    },
    "cmake-js": {
        "runtime": "electron",
        "runtimeVersion": "16.0.10"
      }
}

已尝试但无效的方案 #

• 在package.json中添加"postinstall": "electron-builder install-app-deps"
• 在CMakeLists.txt中添加set(DELAY_LOAD_HOOK "hook/win_delay_load_hook.cc")

可行修复方案 #

1. 静态链接VC++运行时库 #

你的Node Addon使用Visual Studio 2019编译，Windows 10可能未预装对应版本的VC运行时，导致DLL初始化失败。在CMakeLists.txt中添加以下编译选项，将VC运行时静态嵌入到Addon中：

set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /MT")
set(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /MT")

修改后重新编译x86和x64版本的Addon，再打包测试。

2. 确认Electron版本与目标系统兼容性 #

Electron 16.x要求Windows 10最低版本为10.0.17763，若目标Windows 10系统版本低于此，会出现兼容性问题：

• 检查目标Windows 10系统版本，若版本过低，降级Electron到支持更低版本的分支（比如Electron 14.x支持Windows 10 1607及以上）
• 修改package.json中的electron版本后，重新执行npm install和electron-rebuild

3. 确保打包架构与目标系统匹配 #

若你在x64的Windows 11上编译，默认打包的便携版仅支持x64架构，若目标Windows 10是x86系统，会出现架构不匹配：

• 修改打包命令，同时生成x64和x86版本的便携包：

electron-builder --win portable --x64 --ia32

• 确保build:addon:x86和build:addon:x64命令已正确执行，且对应的Addon文件被复制到打包目录中

4. 排查系统DLL版本差异 #

Windows 11与Windows 10的部分系统DLL存在版本差异，Addon若依赖高版本特性会初始化失败：

• 使用Dependency Walker工具分析Addon文件，排查是否依赖Windows 11独有的DLL
• 若存在此类依赖，修改Addon代码避免使用高版本API，或通过延迟加载处理缺失情况

5. 配置electron-builder打包时包含所有依赖DLL #

在package.json中添加build配置，确保Addon依赖的所有DLL都被打包到便携版中：

"build": {
  "win": {
    "portable": {
      "artifactName": "${productName}.portable.exe"
    },
    "extraFiles": [
      {
        "from": "./build_Win32/Release",
        "to": ".",
        "filter": ["*.dll"]
      },
      {
        "from": "./build_x64/Release",
        "to": ".",
        "filter": ["*.dll"]
      }
    ]
  }
}

内容的提问来源于stack exchange，提问作者이민우