Drizzle ORM 中 SQLite 默认时间戳字段的注意事项

在使用 Drizzle ORM 的 Studio 功能时，开发者可能会遇到一个关于 SQLite 数据库默认时间戳字段的有趣现象。本文将从技术角度分析这个问题，帮助开发者更好地理解和使用 Drizzle ORM 的时间戳功能。

问题现象

当开发者使用 Drizzle ORM 定义如下 SQLite 表结构时：

export const user = sqliteTable("user", {
  id: text("id").notNull().primaryKey(),
  name: text("name").notNull(),
  email: text("email").notNull(),
  createdAt: text("created_at")
    .default(sql`CURRENT_TIMESTAMP`)
    .notNull(),
});

通过 Studio 的"添加记录"功能创建新记录时，created_at 字段会被填充为字符串"CURRENT_TIMESTAMP"而不是实际的当前时间戳。然而，如果直接通过 SQL 语句插入记录，该字段则会正确设置为插入时的当前时间。

技术分析

这个行为差异揭示了 Drizzle ORM Studio 与直接 SQL 执行在处理默认值时的不同机制：

1. SQL 直接执行：当执行原生 SQL 插入语句时，SQLite 引擎会识别 CURRENT_TIMESTAMP 关键字并自动替换为当前时间。

2. Studio 界面操作：在 Studio 的添加记录功能中，系统可能直接将默认值表达式作为字符串值插入，而没有经过 SQLite 引擎的解析处理。

解决方案

针对这个问题，Drizzle 团队已经在较新版本中修复了这个行为。开发者可以采取以下措施：

1. 升级到最新版本的 Drizzle ORM 和 Drizzle Kit，确保使用包含修复的版本。

2. 对于时间戳字段，也可以考虑在应用层设置默认值，而不是依赖数据库的默认值机制：

createdAt: text("created_at")
  .default(new Date().toISOString())
  .notNull(),

最佳实践

在使用 ORM 工具时，对于时间戳字段的处理建议：

1. 明确区分是在数据库层还是应用层处理时间戳
2. 在生产环境中，建议对关键时间字段进行双重验证
3. 对于重要的时间记录，考虑添加额外的应用层日志

通过理解这些底层机制，开发者可以更有效地利用 Drizzle ORM 的功能，避免在实际开发中遇到类似的时间戳处理问题。