Electron实现“仅首次运行时创建SQLite数据库”

在桌面应用中，SQLite因其轻量、嵌入式特性成为本地存储的热门选择。但若重复初始化数据库，会导致数据覆盖或冗余。本文将详解如何让Electron应用仅在首次启动时创建SQLite数据库，后续启动直接连接现有库。

一、核心逻辑与实现原理

核心思路：通过检测数据库文件是否存在，决定是否执行建表操作。
关键技术点：

1. 路径管理：使用Electron的app.getPath('userData')获取用户数据目录，确保数据库文件持久化存储。
2. 文件存在性检查：通过Node.js的fs.existsSync()判断数据库文件是否已创建。
3. 条件化初始化：仅当文件不存在时，执行建表SQL语句。

二、分步实现代码

以下以主进程（main.js）为例，整合sqlite3和path模块：

const { app, BrowserWindow, ipcMain } = require('electron');
const path = require('path');
const fs = require('fs');
const sqlite3 = require('sqlite3').verbose();

function createWindow() {
  // 窗口创建逻辑
}

app.whenReady().then(() => {
  // 定义数据库路径（用户数据目录下）
  const userDataPath = app.getPath('userData');
  const dbPath = path.join(userDataPath, 'app_database.db');
  
  // 关键逻辑：仅在文件不存在时初始化数据库
  if (!fs.existsSync(dbPath)) {
    const db = new sqlite3.Database(dbPath, (err) => {
      if (err) console.error('Database creation failed:', err);
      else {
        // 执行建表语句
        db.run(`
          CREATE TABLE IF NOT EXISTS users (
            id INTEGER PRIMARY KEY AUTOINCREMENT,
            name TEXT NOT NULL,
            email TEXT UNIQUE
          )
        `, (err) => {
          if (err) console.error('Table creation error:', err);
          else console.log('Database & tables initialized!');
        });
      }
    });
  } else {
    console.log('Existing database connected.');
  }

  createWindow();
});

三、关键优化与注意事项

1. 避免重复初始化
   • 使用CREATE TABLE IF NOT EXISTS代替CREATE TABLE，防止后续运行时误删表。
2. 异步安全
   • 数据库操作需封装在app.whenReady()内，确保Electron初始化完成后再访问文件系统。
3. 路径动态生成
   • 开发环境与生产环境的路径差异需通过app.isPackaged区分。
4. 错误处理
   • 封装Promise或try/catch捕获文件操作及SQL执行异常。

四、进阶场景：封装为可复用模块

将数据库逻辑独立为database.js模块：

// database.js
const initDatabase = () => {
  const dbPath = path.join(app.getPath('userData'), 'app.db');
  if (!fs.existsSync(dbPath)) {
    const db = new sqlite3.Database(dbPath);
    db.exec(`
      CREATE TABLE settings (key TEXT PRIMARY KEY, value TEXT);
      INSERT INTO settings (key, value) VALUES ('first_run', 'true');
    `);
    return db;
  }
  return new sqlite3.Database(dbPath); // 返回现有连接
};

module.exports = { initDatabase };

主进程中调用：

const { initDatabase } = require('./database');
app.whenReady().then(() => {
  const db = initDatabase();
  // 其他逻辑
});

五、常见问题排查

六、替代方案对比