嵌入式系统中如何通过预安装SQLite3驱动实现Node.js调用

架构老林

2026-8-10

利用系统预安装SQLite3在Node.js中使用的解决方法

核心思路

npm安装sqlite3失败多因嵌入式环境缺少编译工具链，无法构建原生模块。可通过两种方式解决：改用无需编译的纯JS SQLite库，或配置sqlite3包基于系统已装SQLite编译。

方法1：使用纯JavaScript SQLite库（推荐）

这类库无需编译，直接适配Node.js运行环境：

安装依赖：
```
npm install sqlite
```

示例代码：

const sqlite3 = require('sqlite').verbose();
// 连接本地数据库文件，或使用:memory:创建内存库
const db = new sqlite3.Database('./test.db');

db.serialize(() => {
  // 创建表
  db.run("CREATE TABLE IF NOT EXISTS demo (id INTEGER PRIMARY KEY, content TEXT)");
  // 插入数据
  db.run("INSERT INTO demo (content) VALUES (?)", ['Hello SQLite']);
  // 查询数据
  db.each("SELECT * FROM demo", (err, row) => {
    if (err) throw err;
    console.log(`ID: ${row.id}, Content: ${row.content}`);
  });
});

db.close();

方法2：配置`sqlite3`基于系统SQLite编译

若必须使用官方sqlite3包，需指定系统SQLite路径强制本地编译：

先安装编译依赖（嵌入式系统需确保有make、gcc、libsqlite3-dev这类工具）
执行安装命令，指定系统SQLite的安装路径（通常为/usr）：
```
npm install sqlite3 --build-from-source --sqlite=/usr
```

验证安装：

const sqlite3 = require('sqlite3').verbose();
const db = new sqlite3.Database(':memory:');
db.get('SELECT sqlite_version() AS ver', (err, result) => {
  if (err) throw err;
  console.log('当前使用SQLite版本:', result.ver); // 应输出3.38.5
});
db.close();