Drizzle ORM 中 timestamp(3) 类型的数据丢失问题解析

在 PostgreSQL 数据库开发中，时间戳字段是常见的需求。Drizzle ORM 作为一个现代化的 TypeScript ORM 工具，提供了精确到毫秒的时间戳支持（timestamp(3)）。然而，近期开发者在使用过程中发现了一个潜在的数据风险：当使用 drizzle-kit 的 push 命令同步数据库结构时，可能会导致 timestamp(3) 类型字段的数据被意外清空。

问题现象

开发者在使用 Drizzle ORM 定义表结构时，通常会这样声明时间戳字段：

createdAt: timestamp("createdAt", { precision: 3 }).notNull()

但在执行 drizzle-kit push:pg 命令时，系统错误地将 timestamp(3) 和 timestamp (3)（注意空格差异）识别为不同的类型，从而触发表格重建操作，导致现有数据丢失。

技术原理

这个问题源于 Drizzle ORM 内部对 PostgreSQL 类型声明的处理方式。在 PostgreSQL 中，timestamp(3) 表示精确到毫秒的时间戳类型，括号内的数字表示小数秒的精度。Drizzle ORM 在生成 SQL 时，对空格的处理不够严谨：

1. 类型定义中 timestamp 和括号之间可能存在空格
2. 数据库系统实际存储的类型定义可能没有这个空格
3. 在 schema 比对时，这种细微差异被误判为类型不匹配

临时解决方案

在官方修复发布前，开发者可以采用以下临时方案：

1. 使用字符串模式声明时间戳：

createdAt: timestamp("createdAt", { precision: 3, mode: 'string' }).notNull()

2. 手动修改 node_modules 中 drizzle-orm 的源码，移除 timestamp.ts 文件中的多余空格

3. 使用社区提供的临时修复包

最佳实践建议

1. 在进行数据库结构变更前，务必先备份重要数据
2. 考虑在开发环境使用迁移（migration）而非直接 push
3. 对于时间戳字段，评估是否真的需要毫秒级精度
4. 关注官方更新，及时升级到修复版本

问题修复

该问题已在最新版本的 drizzle-kit 中得到修复。开发者升级后即可避免此类数据丢失风险。建议所有用户及时更新依赖项，确保开发环境的稳定性。

这个案例提醒我们，在数据库工具链中，即使是看似微小的语法差异（如空格）也可能导致严重后果。作为开发者，我们需要对数据保持敬畏之心，在工具选择和使用上都要谨慎行事。