T3 Stack中Drizzle ORM与SQLite时间戳处理的常见问题解析

在T3 Stack技术栈中，Drizzle ORM作为轻量级ORM解决方案，与SQLite数据库的配合使用是一个常见组合。然而，开发者在处理时间戳字段时容易遇到一个典型问题——使用CURRENT_TIMESTAMP作为整数类型时间戳的默认值会导致数据异常。

问题现象

当开发者使用T3 Stack模板创建应用时，如果选择了Drizzle ORM和SQLite数据库组合，模板会自动生成包含时间戳字段的数据表定义。这些时间戳字段通常被定义为整数类型（integer），但却错误地使用了CURRENT_TIMESTAMP作为默认值。

在实际运行中，当查询这些表时，时间戳字段会返回"Invalid Date"的错误值。这是因为SQLite将文本格式的时间戳存储在了整数类型的字段中，导致Drizzle ORM无法正确解析。

技术原理

SQLite处理时间戳有两种主要方式：

1. 文本格式时间戳：使用CURRENT_TIMESTAMP会生成UTC格式的文本时间戳（如"2024-06-29 12:34:56"）
2. Unix时间戳：使用unixepoch()函数会返回自1970-01-01以来的秒数

当字段定义为整数类型时，应该使用Unix时间戳格式，因为：

• 整数类型字段无法正确存储文本格式的时间戳
• Unix时间戳是纯数字，与整数类型定义完全匹配
• 大多数JavaScript/TypeScript日期处理库都原生支持Unix时间戳

解决方案

正确的表定义应该使用unixepoch()函数作为默认值，并且明确指定字段类型为integer而非int：

export const users = sqliteTable('users', {
  id: integer('id').primaryKey(),
  createdAt: integer('createdAt', { mode: 'timestamp' })
    .notNull()
    .default(sql`(unixepoch())`),
});

关键修改点包括：

1. 将CURRENT_TIMESTAMP替换为unixepoch()
2. 确保使用integer类型而非int
3. 显式指定mode: 'timestamp'以帮助Drizzle正确进行类型转换

实际影响

这个问题会影响所有使用T3 Stack模板并选择Drizzle+SQLite组合的新项目。主要影响包括：

1. 无法正确获取记录的创建/更新时间
2. 可能导致前端显示异常（显示"Invalid Date"）
3. 时间相关的查询和排序功能失效

最佳实践

除了修正默认值函数外，在处理SQLite时间戳时还建议：

1. 保持一致性：所有时间戳字段统一使用Unix时间戳格式
2. 添加注释：在schema中注明时间戳的单位（秒/毫秒）
3. 考虑时区：明确应用处理的时区策略，前端显示时做相应转换
4. 测试验证：编写单元测试验证时间戳的存储和读取逻辑

通过遵循这些实践，可以确保时间数据在T3 Stack应用中的正确处理和可靠存储。