Nextjs项目中npm install sqlite3失败求助（双终端均报错）

算力阿峰

2026-6-24

解决Next.js中Knex连接MySQL却要求安装sqlite3且安装失败的问题

一、根本解决：无需安装sqlite3，直接配置MySQL驱动

Knex默认会尝试加载sqlite3作为 fallback 驱动，但你实际使用的是MySQL，完全可以跳过sqlite3的安装，步骤如下：

安装MySQL对应的Knex驱动（官方推荐mysql2）：
```
npm install mysql2 --save
```

在Knex配置文件（knexfile.js）中明确指定client为mysql，示例配置：

module.exports = {
  development: {
    client: 'mysql',
    connection: {
      host: '127.0.0.1',
      user: '你的数据库用户名',
      password: '你的数据库密码',
      database: '你的数据库名'
    }
  }
};

配置完成后，Knex会直接使用mysql2驱动，不再触发sqlite3的依赖检查。

二、若必须安装sqlite3，解决安装失败问题

如果你确实需要sqlite3依赖，针对两种终端的报错分别处理：

1. PowerShell中'||'语法错误

PowerShell不支持||作为语句分隔符，部分npm包的postinstall脚本会用到该语法导致报错：

方案1：切换到CMD执行安装命令
打开CMD，切换到项目目录后执行：
```
npm install sqlite3 --save
```
方案2：临时跳过脚本执行，手动编译
先禁用postinstall脚本安装：
```
npm install sqlite3 --save --ignore-scripts
```
之后手动编译sqlite3：
```
npx node-pre-gyp rebuild --prefix node_modules/sqlite3
```

2. Git Bash中找不到node可执行文件

该问题是Git Bash未正确识别node的环境变量路径：

方案1：使用node的绝对路径执行npm
找到你的node安装路径（默认是C:\Program Files\nodejs），执行：
```
"C:\Program Files\nodejs\npm.cmd" install sqlite3 --save
```
方案2：检查并配置系统环境变量
确保node的安装目录已添加到系统PATH中，重启Git Bash后再执行安装命令。
方案3：加载bash配置文件
在Git Bash中执行：
```
source ~/.bashrc
# 或
source ~/.profile
```
之后再执行npm install sqlite3 --save。