在NextJS中如何创建持久化SQLite数据库连接？

你的问题核心是Next.js API路由的无状态特性导致模块重复加载，进而重复初始化数据库连接和预编译语句。其实可以利用Node.js的模块缓存和全局变量来实现持久化，不用每次请求都打开关闭连接。

解决方案：单例模式实现持久化连接 #

Node.js的模块会被缓存，生产模式下dbHelper.js只会被加载一次，所以连接和预编译语句能保持持久化。但开发模式下Next.js的热重载会重新加载模块，需要用globalThis来存储实例避免重复创建。优化后的代码如下：

// lib/dbHelper.js
import Database from "better-sqlite3";

let db;
let getMessagesStatement;

if (process.env.NODE_ENV === "production") {
  // 生产模式：模块缓存保证单例
  db = new Database("./data/thedata.db");
  getMessagesStatement = db.prepare("SELECT * FROM messages LIMIT ? OFFSET ?");
} else {
  // 开发模式：用globalThis存储实例，避免热重载重复初始化
  if (!globalThis.sqliteDb) {
    globalThis.sqliteDb = new Database("./data/thedata.db");
    globalThis.getMessagesStmt = globalThis.sqliteDb.prepare("SELECT * FROM messages LIMIT ? OFFSET ?");
  }
  db = globalThis.sqliteDb;
  getMessagesStatement = globalThis.getMessagesStmt;
}

function getMessages(fromIdx = 0, maxResults = 100) {
  return getMessagesStatement.all(parseInt(maxResults), parseInt(fromIdx));
}

// 生产模式下，在进程退出时关闭数据库连接（可选但推荐）
if (process.env.NODE_ENV === "production") {
  process.on("exit", () => {
    db.close();
  });
}

export { getMessages };

为什么这个方案可行？ #

• 生产模式：Node.js会缓存已加载的模块，dbHelper.js只会被初始化一次，数据库连接保持打开，预编译语句也只会编译一次，完全发挥prepare的性能优势。
• 开发模式：热重载时模块会重新执行，但我们用globalThis存储的实例不会被销毁，所以不会重复创建连接和预编译语句。
• better-sqlite3特性：它是同步库，基于Node.js的单线程事件循环，单例连接是线程安全的，不存在并发问题，官方也推荐长期保持连接来提升性能。

关于"每次请求打开关闭连接"的说法 #

有些文章推荐这种方式，大多是针对异步SQLite库（比如sqlite3），或者担心长期连接导致资源泄漏。但better-sqlite3的设计就是支持长期连接的，单例连接不仅安全，还能避免重复建立连接和编译语句的开销，反而更适合你的场景。

注意事项 #

• 确保项目根目录下的data文件夹存在，否则better-sqlite3会无法创建或读取数据库文件。
• 开发模式下如果需要重置数据库连接，只需重启Next.js服务即可。
• 生产环境部署时，要保证数据库文件的读写权限正确，避免出现权限错误。

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