如何使用 Node.js 在 SQLite3 数据库中创建表：从入门到实战

2026-02-08 19:17:26 0条评论 3次阅读 0人点赞

在日常的后端开发中，选择一个轻量、高效且无需复杂配置的数据库往往能让我们事半功倍。你是否也曾为了快速搭建一个原型或者一个小型的本地应用而苦恼于数据库的繁琐配置？如果是，那么你一定会爱上 SQLite。结合 Node.js 强大的生态，我们可以轻松地构建出功能完备的数据持久层。在这篇文章中，我们将深入探讨如何使用 Node.js 在 SQLite3 数据库中创建表，不仅涵盖基础的连接和建表操作，还会分享一些在实际开发中积累的经验和最佳实践。

为什么选择 Node.js 与 SQLite3？

在开始编码之前，让我们先聊聊为什么这个组合如此强大。SQLite 是一个遵循 ACID 的事务型数据库引擎，它被设计为无需单独的服务器进程或系统配置，这就意味着数据库是直接存储在磁盘文件中的，或者是内存中的。这对于嵌入式设备、本地开发环境以及中小型规模的应用来说，简直是完美的选择。而 Node.js 凭借其非阻塞 I/O 和事件驱动的特性，非常适合处理与数据库之间的异步交互。当我们把两者结合起来，就获得了一套“开箱即用”的高效数据存储解决方案。

环境准备与项目初始化

在我们开始编写代码之前，首先需要搭建好开发环境。请确保你的机器上已经安装了 Node.js。如果你还没有安装，可以去 Node.js 官网下载最新的 LTS 版本。

第 1 步：创建项目目录

首先，让我们打开终端（或命令行工具），为我们的新项目创建一个专门的文件夹。这有助于保持项目结构的整洁。

mkdir sqlite-node-demo
cd sqlite-node-demo

第 2 步：初始化项目

接下来，我们需要在该目录下初始化一个 Node.js 项目。这将帮助我们管理依赖项和脚本。输入以下命令并按回车：

npm init -y

执行完这个命令后，你会发现在目录下生成了一个 package.json 文件。这个文件是我们项目的“身份证”，里面记录了项目的元数据和依赖包信息。

第 3 步：安装必要的依赖

为了与 SQLite 数据库进行交互，我们需要安装官方的驱动程序 INLINECODE6edda1c9。同时，为了便于后续演示（如果你需要构建 Web 服务），我们也可以顺带安装 INLINECODEd778f82e，但本文的核心将聚焦于数据库操作。

npm install sqlite3

安装过程可能需要几秒钟，取决于你的网络速度。一旦安装完成，我们的环境准备工作就大功告成了。接下来，让我们正式进入代码的世界。

建立数据库连接：第一步至关重要

在创建表之前，我们首先得有一个数据库实例。在 Node.js 的 sqlite3 模块中，一切操作都始于创建一个数据库连接对象。

代码示例 1：连接数据库（文件模式）

让我们创建一个名为 main.js 的文件，并写入以下代码：

// 引入 sqlite3 模块
const sqlite3 = require(‘sqlite3‘).verbose();

// 创建一个数据库连接
// 如果文件不存在，SQLite 会自动创建它；如果存在，则直接连接
const db = new sqlite3.Database(‘./my_database.db‘, (err) => {
  if (err) {
    console.error(‘无法连接到数据库:‘, err.message);
  } else {
    console.log(‘已成功连接到 SQLite 数据库。‘);
  }
});

// 稍后我们将在这里添加创建表的代码

深入解析：

在上面的代码中，我们使用了 INLINECODE29f9c9ae 方法。这有什么作用呢？它会启用 INLINECODE278b04cf 驱动的详细日志模式，在控制台输出执行的 SQL 语句和堆栈跟踪信息。这对于开发阶段的调试非常有帮助，但在生产环境中，为了性能考虑，通常会将其移除。

此外，注意到我们传入的路径是 ./my_database.db。这是一个相对路径，SQLite 会在当前工作目录下寻找或创建这个文件。你也可以指定绝对路径。

内存数据库（可选了解）

有时候，我们只是想做一些快速测试，不希望在磁盘上留下数据文件。这时，我们可以使用内存数据库：

const db = new sqlite3.Database(‘:memory:‘, (err) => {
  if (err) {
    console.error(err.message);
  }
  console.log(‘已连接到内存数据库。‘);
});

请注意，内存数据库的数据易失性：一旦连接关闭或程序终止，所有数据都会消失。它非常适合用于单元测试。

构建表结构：定义数据的家

连接建立好之后，我们就可以开始“建造房子”了——也就是创建表。在关系型数据库中，表是存储数据的基本单元。我们需要使用 SQL 的 CREATE TABLE 语句来定义表的结构。

代码示例 2：创建一个简单的用户表

让我们设计一个用于存储用户信息的表。我们需要用户的 ID（作为唯一标识）、用户名、电子邮箱和注册时间。

const sqlite3 = require(‘sqlite3‘).verbose();

// 连接到数据库
const db = new sqlite3.Database(‘./my_database.db‘);

// SQL 语句定义表结构
// 我们使用 CREATE TABLE IF NOT EXISTS 来防止重复创建导致的错误
const createUsersTableSQL = `
  CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY AUTOINCREMENT, 
    -- AUTOINCREMENT 确保 ID 自动增长，即便删除了旧数据
    
    username TEXT NOT NULL, 
    -- NOT NULL 约束确保用户名不能为空
    
    email TEXT UNIQUE NOT NULL, 
    -- UNIQUE 约束确保邮箱地址在系统中是唯一的
    
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP 
    -- 默认值为当前时间戳
  )`;

// 执行 SQL 创建表
db.run(createUsersTableSQL, (err) => {
  if (err) {
    console.error(‘创建表时发生错误:‘, err.message);
  } else {
    console.log(‘users 表创建成功！‘);
  }

  // 记得关闭数据库连接
  db.close((err) => {
    if (err) {
      console.error(‘关闭数据库连接时出错:‘, err.message);
    }
  });
});

代码深度解析：

  • INLINECODE14955ccf: 这是一个最佳实践。如果你的脚本运行多次，普通的 INLINECODEa6f11da2 会导致报错（表已存在）。加上这个判断后，如果表不存在则创建，如果存在则什么都不做，非常安全。
  • INLINECODE47ddbc4d: 在 SQLite 中，声明 INLINECODE14df5490 通常会自动创建一个自增的 RowID。加上 AUTOINCREMENT 关键字后，可以保证即使你删除了最后插入的行，新插入的行 ID 也不会复用旧 ID，这在某些安全场景下很有用。
  • INLINECODE6403835d: 我们使用了 INLINECODEd283322b 方法。这个方法专门用于执行那些不返回数据的 SQL 语句，比如 INLINECODE68182831、INLINECODEb1b9d024、INLINECODE1a42a4fe、INLINECODE8c8c05f7 等。这也是我们创建表的核心方法。

进阶实战：处理更复杂的场景

在实际的项目中，我们很少只创建一张表。通常我们会设计有关系联的多张表，并且需要在创建完表后立即插入一些初始数据。让我们看一个更完整的例子。

代码示例 3：创建关联表并处理错误

假设我们在做一个简单的待办事项应用，我们需要一个“类别表”和一个“任务表”。任务必须属于某一个类别。

const sqlite3 = require(‘sqlite3‘).verbose();

const db = new sqlite3.Database(‘./todo_app.db‘, (err) => {
    if (err) {
        console.error(‘连接错误:‘, err.message);
    } else {
        console.log(‘已连接到 SQLite 数据库。‘);
        initDatabase(); // 连接成功后初始化数据库
    }
});

function initDatabase() {
    // 1. 创建类别表
    const createCategoriesTable = `
        CREATE TABLE IF NOT EXISTS categories (
            id INTEGER PRIMARY KEY AUTOINCREMENT,
            name TEXT NOT NULL
        )`;

    // 2. 创建任务表（包含外键约束）
    // 注意：SQLite 中的外键默认是不强制执行的，需要开启 PRAGMA foreign_keys = ON;
    const createTasksTable = `
        CREATE TABLE IF NOT EXISTS tasks (
            id INTEGER PRIMARY KEY AUTOINCREMENT,
            title TEXT NOT NULL,
            description TEXT,
            category_id INTEGER,
            is_completed BOOLEAN DEFAULT 0,
            FOREIGN KEY(category_id) REFERENCES categories(id)
        )`;

    // 开启外键约束
    db.run("PRAGMA foreign_keys = ON;");

    // 串行执行创建语句，确保表创建顺序正确
    db.serialize(() => {
        // 执行创建类别表
        db.run(createCategoriesTable, (err) => {
            if (err) {
                console.error(‘创建 categories 表失败:‘, err.message);
            } else {
                console.log(‘categories 表就绪。‘);
                
                // 插入一些默认类别数据
                db.run("INSERT INTO categories (name) VALUES (‘工作‘), (‘生活‘)");
            }
        });

        // 执行创建任务表
        db.run(createTasksTable, (err) => {
            if (err) {
                console.error(‘创建 tasks 表失败:‘, err.message);
            } else {
                console.log(‘tasks 表就绪。‘);
            }
        });
    });

    // 演示完成后关闭连接
    setTimeout(() => {
        db.close(() => console.log(‘数据库连接已关闭。‘));
    }, 1000);
}

关键知识点：

  • INLINECODEe2ffcf37: 这是一个非常强大的控制流方法。默认情况下，SQLite3 的操作是并行的。但在建表时，如果表 B 依赖表 A，我们必须保证 A 先建好。INLINECODE4da1ad02 强制将其中的操作按顺序排队执行，就像在 JavaScript 中同步执行代码一样。
  • 外键约束 (FOREIGN KEY): 这保证了数据的完整性。如果你试图删除一个类别，而这个类别下还有任务，数据库会阻止这个操作（或者你可以设置为级联删除），防止产生“孤儿数据”。
  • PRAGMA: PRAGMA foreign_keys = ON; 是 SQLite 的一个特殊命令。为了历史性能原因，SQLite 默认不检查外键合法性。在你的 Node.js 应用中，如果你想维护关系完整性，务必在连接建立后开启这个选项。

使用 Promise 和 async/await 现代化你的代码

你可能注意到了，上面的代码都使用了回调函数。当逻辑复杂时，层层嵌套的回调会导致“回调地狱”，使代码难以阅读和维护。在现代 Node.js 开发中，我们更倾向于使用 INLINECODE6864f907 语法。我们可以简单地将 INLINECODE107240dd 等操作封装成 Promise。

代码示例 4：Promise 封装与 async/await 实现

const sqlite3 = require(‘sqlite3‘).verbose();

// 辅助函数：将 db.run 封装为 Promise
function run(db, sql, params = []) {
  return new Promise((resolve, reject) => {
    db.run(sql, params, function (err) {
      if (err) {
        reject(err);
      } else {
        // resolve(this); // 返回 statement 对象，其中包含 this.lastID 等信息
        resolve(); // 如果不需要 lastID，直接 resolve 即可
      }
    });
  });
}

async function createTablesAsync() {
  const db = new sqlite3.Database(‘./async_demo.db‘);
  
  try {
    // 开启外键
    await run(db, "PRAGMA foreign_keys = ON;");
    
    // 创建表
    const sql = `
      CREATE TABLE IF NOT EXISTS products (
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        name TEXT NOT NULL,
        price REAL NOT NULL
      )
    `;
    
    await run(db, sql);
    console.log(‘表创建成功‘);
    
  } catch (err) {
    console.error(‘发生错误:‘, err);
  } finally {
    // 确保无论成功失败都关闭连接
    db.close();
  }
}

createTablesAsync();

这种方式让代码逻辑线性化，非常清晰。虽然原生 sqlite3 库在最新版本中也内置了一些 Promise 支持，但了解如何手动封装能让你对底层机制理解更深。

常见陷阱与最佳实践

在与 Node.js 和 SQLite 共事的过程中，我们踩过不少坑。这里有几条经验分享，希望能帮你避开弯路。

  • 数据类型灵活性：SQLite 的数据类型是动态的。虽然你定义了 INTEGER，其实你可以存入文本（虽然不推荐）。为了保证数据质量，我们建议在应用层（JS 代码）和数据库层都做好类型校验。
  • 单写入限制：SQLite 在同一时刻只允许一个写入操作。如果你的应用并发量极高，可能会有“database is locked”的错误。对于 Web 应用来说，通常 sqlite3 驱动会帮你排队处理写入操作，但要注意不要在复杂的回调中进行长时间的计算，这会阻塞队列。
  • 连接管理：在脚本中，我们通常会在结束时调用 INLINECODE605deac0。但在 Web 服务器（如 Express）中，通常我们在应用启动时创建一个全局的 INLINECODE07c51f59 对象，并在整个应用生命周期中保持连接，不要每次请求都打开和关闭连接，那样会极大地降低性能。
  • 错误处理：永远不要忽略回调中的 err 对象。建表失败通常是因为 SQL 语法错误或权限问题，忽略错误会导致后续查询直接报错，难以调试。

结语

我们不仅学会了如何用几行简单的 Node.js 代码在 SQLite3 中创建表，还深入探讨了外键约束、事务控制流、以及如何用现代 async/await 语法美化我们的数据库操作。SQLite 是一个被低估的强大工具，它足以支撑成千上万次的日常读取操作，而且部署极其简单，只需复制一个 .db 文件即可。

在你接下来的项目中，不妨试着用今天学到的知识去构建你的数据层。无论是本地工具还是小型 Web 服务，Node.js 与 SQLite3 的组合都能让你专注于业务逻辑，而不是复杂的数据库运维。希望这篇文章能成为你开发路上的得力助手。如果你在实操中遇到了任何问题，欢迎随时查阅官方文档或在社区中寻求帮助。祝你编码愉快！

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。如需转载，请注明文章出处豆丁博客和来源网址。https://shluqu.cn/36986.html
点赞
0.00 平均评分 (0% 分数) - 0 票

相关文章美国1G带宽/1T流量高速vps $17.99/年