Nextron应用安装sqlite3后出现系列模块解析及导入错误求助

已解决问题回顾 #

安装sqlite3后遇到的前两个模块解析错误，已通过在next.config.js中添加以下webpack规则解决：

• 处理HTML文件：

  config.module.rules.push({ test: /\.html$/, use: "html-loader" });
  

• 处理CS文件：

  config.module.rules.push({
      test: /\.cs$/,
      use: "raw-loader",
  });
  

剩余问题及解决方法 #

问题1：导入错误 - 找不到electron.asar/package.json #

该错误源于sqlite3作为原生模块未针对Electron环境正确编译，或打包时被asar包处理导致路径异常，解决步骤如下：

1. 重新编译sqlite3适配Electron
   安装electron-rebuild工具专门处理原生模块的Electron适配：

   npm install --save-dev electron-rebuild
   

   执行重建命令：

   npx electron-rebuild -f -w sqlite3
   

   也可在package.json的scripts中添加命令后运行：

   "scripts": {
     "rebuild": "electron-rebuild -f -w sqlite3"
   }
   

   npm run rebuild
   

2. 配置electron-builder排除sqlite3的asar打包
   在package.json的build字段中添加配置，让sqlite3的原生文件不被打包进asar包：

   "build": {
     "asar": true,
     "asarUnpack": [
       "node_modules/sqlite3/**/*"
     ]
   }
   

问题2：替换为better-sqlite3时出现undefined indexOf错误 #

该问题多由版本不兼容或原生模块未正确编译导致，解决方法如下：

1. 安装兼容版本的better-sqlite3
   Node v16.20.0建议使用better-sqlite3 v7.6.2版本（更高版本需Node 18+支持）：

   npm install better-sqlite3@7.6.2
   

2. 重建better-sqlite3
   用electron-rebuild重新编译适配Electron：

   npx electron-rebuild -f -w better-sqlite3
   

3. webpack配置排除原生模块
   在next.config.js的webpack配置中添加externals，避免webpack打包原生模块：

   module.exports = {
     webpack: (config, { isServer }) => {
       // 保留已有的loader配置
       config.module.rules.push({ test: /\.html$/, use: "html-loader" });
       config.module.rules.push({
           test: /\.cs$/,
           use: "raw-loader",
       });
       // 添加externals排除原生模块
       config.externals.push('better-sqlite3');
       return config;
     }
   };
   

额外注意事项 #

• 清理现有依赖后重新安装：删除node_modules、package-lock.json，执行npm install后再进行重建操作。
• 确认Electron版本兼容性：Node v16对应推荐Electron版本为v18.x~v20.x，避免版本不匹配导致编译失败。

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