Ubuntu22.04下npm安装sqlite3失败，清理缓存仍无法解决

我正在开发基于Express.js和Sequelize的后端，操作系统为Ubuntu 22.04，Node版本18.13.0，npm版本9.3.1。执行npm install sqlite3 --save时出现报错：

>  npm install sqlite3 --save
npm WARN deprecated @npmcli/move-file@1.1.2: This functionality has been moved to @npmcli/fs
npm ERR! code 1
npm ERR! path /home/heikki/Koodaus/frostmark/fm-character-sheet/server/node_modules/sqlite3
npm ERR! command failed
npm ERR! command sh -c node-pre-gyp install --fallback-to-build

npm ERR! A complete log of this run can be found in:
npm ERR!     /home/heikki/.npm/_logs/2023-01-22T13_51_17_296Z-debug-0.log

日志中的详细堆栈信息：

716 verbose stack Error: command failed
716 verbose stack     at ChildProcess.<anonymous> (/usr/local/lib/node_modules/npm/node_modules/@npmcli/promise-spawn/lib/index.js:53:27)
716 verbose stack     at ChildProcess.emit (node:events:513:28)
716 verbose stack     at maybeClose (node:internal/child_process:1091:16)
716 verbose stack     at ChildProcess._handle.onexit (node:internal/child_process:302:5)
717 verbose pkgid sqlite3@5.1.4

已尝试的无效方案：

• 清理缓存（执行npm cache clean时提示需用--force或npm cache verify）、删除node_modules和package-lock.json后重新安装
• 安装旧版本sqlite3@4.1.1
• 全局安装node-gyp、node-pre-gyp
• 通过apt安装sqlite3 libsqlite3-dev python-is-python3

仅yarn add sqlite3可绕过该问题，求其他解决办法及进一步调试方案。

1. 指定预编译二进制包或强制源码编译 #

由于Node 18与sqlite3 5.x的预编译包可能存在兼容性匹配问题，可强制基于系统现有sqlite库编译：

npm install sqlite3 --save --build-from-source --sqlite_libname=sqlite3 --sqlite=/usr/lib/x86_64-linux-gnu

或者指定可靠的预编译包源：

npm_config_sqlite3_binary_host=https://github.com/TryGhost/node-sqlite3/releases/download npm install sqlite3 --save

2. 升级编译依赖适配Node 18 #

全局安装适配Node 18的node-gyp版本：

npm uninstall -g node-gyp
npm install -g node-gyp@latest

同时补全系统编译基础依赖：

sudo apt install build-essential libssl-dev

3. 跳过peer依赖冲突检查 #

部分依赖版本冲突会阻断编译流程，尝试：

npm install sqlite3 --save --legacy-peer-deps

4. 替换为无编译依赖的替代包 #

尝试使用better-sqlite3（无需node-pre-gyp，性能更优）：

npm install better-sqlite3 --save

在Sequelize中配置使用该包：

const sequelize = new Sequelize('database', 'username', 'password', {
  dialect: 'sqlite',
  dialectModule: require('better-sqlite3'),
  storage: './database.sqlite'
});

1. 查看完整编译细节：
   重新执行安装并开启 verbose 模式，或直接查看报错日志文件：

   npm install sqlite3 --save --verbose
   

   重点查找node-pre-gyp下载失败、gcc编译报错的具体信息，比如缺失依赖、版本不兼容提示。

2. 手动执行编译命令：
   进入sqlite3目录单独执行编译，定位失败环节：

   cd node_modules/sqlite3
   node-pre-gyp install --fallback-to-build --verbose
   

3. 检查网络与镜像源：
   确认是否存在代理或镜像源导致预编译包下载失败：

   echo $HTTP_PROXY $HTTPS_PROXY
   npm config get registry
   

   可临时切换回官方npm源测试：

   npm config set registry https://registry.npmjs.org/
   

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