update

tests/unit/main/native-module.test.ts

@@ -0,0 +1,97 @@
+// tests/unit/main/native-module.test.ts
+//
+// 守卫:当前测试运行器下 better-sqlite3 原生模块必须真的能加载并读写。
+//
+// 为什么要有这条(2026-10-19 实地复现):
+//   better-sqlite3 不是 N-API,一个 .node 只对应一个 ABI —— Electron 30.5 用
+//   ABI 123,系统 Node 24 用 ABI 137,两者共用同一个
+//   node_modules/better-sqlite3/build/Release/better_sqlite3.node。
+//   旧 pretest 钩子为了跑测试会**破坏性重建**这份模块(把 app 那份覆盖成
+//   Node 版),Windows 上文件被运行中的 electron 进程锁住 → EBUSY →
+//   整条 `npm run test:run` 中止,哪怕测试本身全绿。
+//
+//   现在 scripts/run-tests.cjs 改成自适应:能用系统 Node 加载就用系统 Node,
+//   否则用 Electron 自带 Node 跑(ELECTRON_RUN_AS_NODE=1),测试与 app 共用
+//   同一份原生模块,不再有互相覆盖。
+//
+//   这条测试锁住「跑测试的那条路线下原生模块可用」这个前提 ——
+//   将来谁再把 pretest 换回 `npm rebuild better-sqlite3`,或让 CI 换回
+//   裸 `npx vitest run`,这条会以「模块加载失败 + 该用哪条命令」的形式立刻
+//   暴露,而不是变成一堆莫名其妙的 SQLITE_CANTOPEN。
+//
+// 兼容性:两条路线下本用例都应通过 ——
+//   - 系统 Node 路线:模块是 Node ABI 版(或 napi 通用版),直接可加载
+//   - Electron 路线:模块是 Electron ABI 版,Electron 自带 Node 可加载
+import { describe, expect, it } from 'vitest';
+
+interface TestDb {
+  exec(sql: string): void;
+  close(): void;
+  prepare(sql: string): {
+    run(...args: unknown[]): { changes: number };
+    get(...args: unknown[]): unknown;
+  };
+  pragma(sql: string): unknown;
+}
+
+type DatabaseCtor = new (path: string) => TestDb;
+
+const ABI_HINT = [
+  '[native-module] 当前测试运行器加载不了 better-sqlite3 原生模块。',
+  '  better-sqlite3 不是 N-API,一个 .node 只对应一个 ABI(Electron / 系统 Node 各一份),',
+  '  两份共用 node_modules/better-sqlite3/build/Release/better_sqlite3.node。',
+  '  请用 `npm run test:run` —— scripts/run-tests.cjs 会自动挑能加载的那条路线',
+  '  (系统 Node 直跑,或 Electron 自带 Node 跑 ELECTRON_RUN_AS_NODE=1);',
+  '  裸 `npx vitest run` 会用系统 Node,而此刻那份 .node 可能是 Electron ABI 的。',
+].join('\n');
+
+/**
+ * 打开内存库。注意:**原生 binding 是构造时才加载的**(require 只是拿到
+ * JS 包装),所以 import 成功不代表 ABI 匹配 —— 必须在 new Database() 外面
+ * 兜 try/catch,否则报的是难懂的 "NODE_MODULE_VERSION 123 vs 137"。
+ */
+async function openMemoryDb(): Promise<TestDb> {
+  let ctor: DatabaseCtor | undefined;
+  try {
+    const mod = (await import('better-sqlite3')) as unknown as { default: DatabaseCtor };
+    ctor = mod.default;
+    return new ctor(':memory:');
+  } catch (err) {
+    expect.fail(
+      `${ABI_HINT}\n  原始错误:${err instanceof Error ? err.message : String(err)}`,
+    );
+    throw err; // eslint-disable-line no-unreachable -- expect.fail 已抛,仅为满足类型
+  }
+}
+
+describe('better-sqlite3 原生模块', () => {
+  it('能打开内存库、建表、写入并读回', async () => {
+    const db = await openMemoryDb();
+    try {
+      db.exec('create table t (a integer primary key, b text not null)');
+      const ins = db.prepare('insert into t (b) values (?)');
+      const res = ins.run('hello');
+      expect(res.changes).toBe(1);
+      const row = db.prepare('select a, b from t where a = ?').get(1) as {
+        a: number;
+        b: string;
+      };
+      expect(row).toEqual({ a: 1, b: 'hello' });
+    } finally {
+      db.close();
+    }
+  });
+
+  it('pragma 可用(主进程依赖 journal_mode / foreign_keys 的行为)', async () => {
+    const db = await openMemoryDb();
+    try {
+      // journal_mode 在内存库上恒为 memory,这里只断言 pragma 调用本身可用
+      expect(() => db.pragma('journal_mode')).not.toThrow();
+      expect(() => db.pragma('foreign_keys = ON')).not.toThrow();
+      const fk = db.pragma('foreign_keys') as Array<{ foreign_keys: number }>;
+      expect(fk[0]?.foreign_keys).toBe(1);
+    } finally {
+      db.close();
+    }
+  });
+});