Drizzle ORM 中 SQLite 函数默认值问题的分析与解决

在使用 Drizzle ORM 操作 SQLite/Turso 数据库时，开发者可能会遇到一个常见问题：通过 Drizzle Studio 或程序代码插入记录时，SQLite 内置函数（如 uuid4() 和 current_timestamp）作为默认值不会自动执行。本文将深入分析这一问题，并提供有效的解决方案。

问题现象

当开发者定义如下表结构时：

export const users = sqliteTable(
  "organizations",
  {
    id: text("id")
      .primaryKey()
      .default(sql`(uuid4())`),
    email: text("email").notNull(),
    updatedAt: text("updated_at")
      .notNull()
      .default(sql`current_timestamp`),
  }
);

对应的 SQLite 建表语句为：

CREATE TABLE `users` (
  `id` text PRIMARY KEY DEFAULT (uuid4()) NOT NULL,
  `email` text NOT NULL,
  `updated_at` text DEFAULT current_timestamp NOT NULL
);

通过以下两种方式插入数据时会出现不同结果：

1. 直接执行 SQL 查询：函数能正常执行，生成 UUID 和时间戳
2. 通过 Drizzle Studio 或程序代码：函数不会执行，而是直接将函数名作为字符串存入数据库

问题原因

这个问题的根源在于 Drizzle ORM 的默认值处理机制：

1. 当通过 ORM 层插入数据时，Drizzle 会将默认值表达式作为字面量传递，而不是作为 SQL 函数执行
2. 这与直接执行 SQL 语句时的行为不同，后者会正确识别并执行 SQL 函数

解决方案

Drizzle ORM 提供了两种解决这个问题的方法：

方法一：使用 $defaultFn

export const users = sqliteTable(
  "organizations",
  {
    id: text("id")
      .primaryKey()
      .$defaultFn(() => crypto.randomUUID()),
    email: text("email").notNull(),
    updatedAt: text("updated_at")
      .notNull()
      .$defaultFn(() => new Date().toISOString()),
  }
);

优点：

• 代码更直观
• 使用 JavaScript 原生函数，确保跨数据库兼容性

缺点：

• 依赖应用层而非数据库层实现
• 在纯 SQL 环境中不会自动执行

方法二：使用原始 SQL 表达式

export const users = sqliteTable(
  "organizations",
  {
    id: text("id")
      .primaryKey()
      .default(sql`(uuid4())`),
    email: text("email").notNull(),
    updatedAt: text("updated_at")
      .notNull()
      .default(sql`current_timestamp`),
  }
);

注意事项：

• 确保在 Drizzle ORM 最新版本中使用
• 某些情况下可能需要额外的配置才能正常工作

最佳实践建议

1. 一致性原则：选择一种方式并在整个项目中保持一致
2. 考虑环境因素：如果需要在数据库层面保证数据一致性，优先使用 SQL 函数
3. 测试验证：在开发环境中充分测试默认值的行为
4. 文档记录：在项目文档中明确记录所采用的默认值策略

总结

Drizzle ORM 在处理 SQLite 函数默认值时存在行为差异，但通过合理使用 $defaultFn 或原始 SQL 表达式可以解决这一问题。开发者应根据项目需求选择最适合的方案，确保数据一致性和应用功能的正常运作。

随着 Drizzle ORM 的持续更新，这类问题可能会得到进一步改善，建议开发者关注项目更新日志，及时获取最新的功能改进和问题修复。