Bun+Drizzle+SQLite组合下更新/插入类型异常求助

问题场景 #

使用以下依赖版本搭建SQLite存储时出现类型推断异常：

• drizzle-orm: ^0.39.3
• drizzle-kit: ^0.30.4

核心问题：

1. Insert类型缺失可选字段：仅包含非空字段（如title），带默认值或可选的字段（如description、meta_description）未出现在NewCategory类型中
2. 更新操作字段不可用：执行db.update(categoriesTable).set({ meta_description: "abc" })时，提示字段不存在
3. 查询返回类型异常：db.query.categoriesTable.findFirst().execute()返回{ [x: string]: unknown; }而非预期的Category | undefined

已确认数据库schema通过Beekeeper验证正确，且此前PostgreSQL环境下Drizzle运行正常。

问题原因 #

1. 数据库路径格式不兼容：Bun SQLite驱动不接受file:前缀的路径，但你从drizzle.config.ts导入的DB_FILE包含该前缀，导致Drizzle无法正确解析数据库元数据，进而丢失字段类型信息。
2. Schema关联失效：路径错误间接导致schema与数据库连接的关联异常，使得类型推断逻辑无法正常读取表结构定义。

修复步骤 #

1. 修正数据库路径配置 #

拆分drizzle-kit与Bun SQLite的路径格式（前者需要file:前缀，后者不需要）：

// drizzle.config.ts
import { defineConfig } from 'drizzle-kit';
export const DB_FILE = "./storage/storage.db"; // 移除file:前缀，适配Bun SQLite
export default defineConfig({
  out: './storage/migrations',
  schema: './storage/tables.schema.ts',
  dialect: 'sqlite',
  dbCredentials: { url: `file:${DB_FILE}` }, // 为drizzle-kit添加file:前缀
  verbose: true,
  strict: true,
});

同步修改数据库连接代码：

// connection.ts
import * as schema from "./tables.schema";
import { drizzle } from 'drizzle-orm/bun-sqlite';
import { DB_FILE } from "./drizzle.config";
import { Database } from 'bun:sqlite';

const sqlite = new Database(DB_FILE, { create: true }); // 使用无file:前缀的路径
export const db = drizzle({ client: sqlite, schema });
export const closeDb = () => sqlite.close();
export const rawDb = sqlite;

2. 显式关联Schema（可选） #

若路径修正后仍有问题，尝试显式传递表对象到drizzle实例：

// connection.ts
import { categoriesTable } from "./tables.schema";
import { drizzle } from 'drizzle-orm/bun-sqlite';
import { DB_FILE } from "./drizzle.config";
import { Database } from 'bun:sqlite';

const sqlite = new Database(DB_FILE, { create: true });
export const db = drizzle(sqlite, { schema: { categoriesTable } });

3. 重新生成元数据（可选） #

执行以下命令重新生成迁移并同步schema，确保类型元数据完全更新：

bunx drizzle-kit generate
bunx drizzle-kit push

验证修复 #

完成上述操作后，重新检查类型逻辑：

• NewCategory类型将包含title（必填）及description、meta_description、updated_at（可选）
• 更新操作可正常设置可选字段
• 查询返回值类型将变为Category | undefined

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