Drizzle ORM 中数组默认值设置的正确方式

在使用 Drizzle ORM 进行 PostgreSQL 数据库开发时，设置数组类型的默认值是一个常见的需求。许多开发者会尝试使用 default([]) 来为数组列设置空数组作为默认值，但这种写法实际上会导致生成的 SQL 语句不完整，进而引发数据库迁移错误。

问题现象

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

field: varchar("col", { length: 64 }).array().notNull().default([])

运行 drizzle-kit generate 命令会成功执行，但生成的迁移文件包含不完整的 SQL 语句：

ALTER TABLE "table" ALTER COLUMN "col" SET DEFAULT ;

这种不完整的 SQL 语句在执行迁移时会抛出 PostgreSQL 语法错误。

正确解决方案

Drizzle ORM 官方文档明确指出，为数组类型设置默认空数组的正确方式应该是：

field: varchar("col", { length: 64 }).array().notNull().default(sql`ARRAY[]::varchar[]`)

这会生成正确的 SQL 语句：

ALTER TABLE "table" ALTER COLUMN "col" SET DEFAULT ARRAY[]::varchar(64)[];

技术背景

在 PostgreSQL 中，数组类型的默认值需要明确指定数组的类型转换。直接使用 [] 作为默认值是不明确的，因为 PostgreSQL 需要知道这个空数组的具体类型。

Drizzle ORM 的 sql 标签允许开发者直接嵌入原始 SQL 片段，这为处理特殊数据类型和复杂默认值提供了灵活性。

最佳实践建议

1. 对于数组类型的默认值，始终使用 sql 标签明确指定类型
2. 在开发过程中，仔细检查生成的迁移文件内容
3. 考虑在团队中分享这类常见问题的解决方案，避免重复踩坑
4. 保持 Drizzle ORM 和相关工具的最新版本，以获得最佳兼容性

这个问题在 Drizzle Kit 0.24.0 版本中已得到修复，建议开发者及时升级工具链。