Electron Forge打包含sqlite3的Electron应用报错，添加externals配置无效求助

数据老陈

2026-7-16

解决Electron Forge + Webpack + SQLite3打包运行报错问题

以下是针对问题的具体解决步骤：

1. 修正Webpack主进程配置

在webpack.main.config.ts中，将externals配置改为指定模块类型的写法（数组形式无法正确识别原生commonjs模块）：

export default {
  // 保留原有其他配置
  externals: {
    sqlite3: 'commonjs sqlite3'
  },
  target: 'electron-main' // 确保此配置存在，主进程Webpack必须指定该target
};

该配置会让Webpack跳过打包sqlite3模块，保留原生模块的引用逻辑。

2. 重新编译SQLite3适配Electron版本

SQLite3是原生模块，需要针对当前Electron版本重新编译，执行命令：

npx electron-rebuild -f -w sqlite3

也可以在package.json中添加postinstall脚本，确保每次安装依赖后自动执行编译：

{
  "scripts": {
    // 保留原有其他脚本
    "postinstall": "electron-rebuild"
  }
}

3. 补充Electron Forge打包配置

在forge.config.ts中添加额外资源配置，确保SQLite3的二进制文件被复制到打包后的应用目录：

import type { ForgeConfig } from '@electron-forge/shared-types';
import { WebpackPlugin } from '@electron-forge/plugin-webpack';
import mainConfig from './webpack.main.config';
import rendererConfig from './webpack.renderer.config';

const config: ForgeConfig = {
  packagerConfig: {
    extraResource: ['./node_modules/sqlite3/lib/binding/']
  },
  plugins: [
    new WebpackPlugin({
      mainConfig,
      renderer: {
        config: rendererConfig,
        entryPoints: [
          {
            html: './src/index.html',
            js: './src/renderer.ts',
            name: 'main_window'
          }
        ]
      }
    })
  ]
};

export default config;