Electron-React-TypeScript-Webpack项目sqlite3非构造函数错误求解

当前异常由两层配置错误叠加导致，和此前完成的electron-rebuild原生模块编译步骤无关联：

• webpack 的 externals 配置存在语法错误，原生模块的排除规则未实际生效
• TypeScript 对 CommonJS 格式的 sqlite3 模块导入映射错误，导致运行时拿到的模块对象不包含 Database 构造器

1. 修正 webpack.externals 配置 #

当前配置存在未定义变量的语法问题，实际排除规则完全没有生效：

// 原有错误写法
externals: [
  {
    'sqlite3': sqlite3, // 此处sqlite3变量从未在配置文件中声明，打包时会触发隐式解析异常
  }
],

针对sqlite3这类带二进制.node文件的原生模块，必须标记为外部依赖，禁止被webpack打包进主进程bundle，正确配置参考：

// 同webpack.config.js内的其他配置
module.exports = {
  target: 'electron-main', // 匹配主进程打包环境
  // 其他原有配置...
  externals: {
    sqlite3: 'commonjs sqlite3', // 明确指定运行时以原生CommonJS方式从node_modules加载sqlite3
  },
};

注意：所有带本地二进制编译产物的Electron原生依赖，都需要在externals中显式声明为commonjs外部依赖，不能被webpack内联打包。

2. 修正TypeScript的sqlite3导入逻辑 #

sqlite3是纯CommonJS导出模块，本身不存在ES规范要求的default导出属性。当前使用的import sqlite3 from 'sqlite3'写法会被TypeScript编译为require('sqlite3').default，但由于sqlite3没有default导出，最终拿到的sqlite3_1.default是undefined，自然无法读取Database构造器。
推荐使用namespace导入方式适配CommonJS模块，无需额外修改TS全局配置：

// 替换原有默认导入写法
import * as sqlite3 from 'sqlite3';

// 后续数据库实例化逻辑保持不变
let db = new sqlite3.Database(
  path.join(app.getPath('userData'), '/infopiecesleveldb'),
  (err) => {
    if (err) {
      return console.error(err.message);
    }
    console.log('Connected to the SQlite database.');
  }
);

如果坚持使用默认导入写法，可以在tsconfig.json中开启esModuleInterop配置，TypeScript会自动帮你处理CommonJS模块的default导出映射，不过namespace导入的兼容性更稳定。

3. 编译结果校验 #

修改配置后重新执行打包流程，打开dist目录下生成的主进程入口文件，搜索sqlite3的引入语句，确认最终生成的代码为const sqlite3 = require('sqlite3')形式，而非被webpack内联进bundle的模块代码。校验完成后重新启动Electron应用，即可消除构造器找不到的报错。

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