Atlas 项目中关于 Postgres 默认值生成 UUID 的迁移问题分析

在数据库迁移工具 Atlas 的使用过程中，PostgreSQL 数据库用户可能会遇到一个特殊现象：当表中列设置了默认值为 gen_random_uuid() 时，Atlas 的迁移脚本会持续生成 SET DEFAULT (gen_random_uuid()) 语句，即使该默认值已经存在于列定义中。

问题本质

这个现象源于 Atlas 在比较默认值时的实现机制。Atlas 通过执行 SQL 查询 SELECT %s = %s 来比较两个默认值是否相同。对于大多数函数如 now()，这种比较会返回 true，因此不会生成冗余的修改语句。然而，gen_random_uuid() 每次调用都会生成不同的 UUID 值，导致比较结果总是 false，从而触发 Atlas 生成修改默认值的语句。

技术背景

PostgreSQL 的 gen_random_uuid() 函数设计用于生成全局唯一标识符，其特性决定了每次调用都会产生不同的结果。这与时间函数 now() 等确定性函数不同，后者在同一个事务中多次调用会返回相同值。

Atlas 的这种比较行为在大多数情况下是合理的，因为它确保了默认值的准确性。但对于 gen_random_uuid() 这类非确定性函数，这种比较方式会产生误判。

解决方案

对于这个问题，Atlas 提供了两种解决思路：

1. 保持定义完全一致：确保 HCL 或 ORM 中的列定义与数据库中的定义完全一致，包括括号等细节。例如，使用 (gen_random_uuid()) 而非 gen_random_uuid()。

2. 使用 Atlas 的差异检测机制：当两个定义完全相同时，Atlas 会跳过默认值的比较检查。这要求开发者在定义模型时保持高度一致性。

最佳实践

对于使用 ORM（如 Ent）定义模型的开发者，建议：

• 明确指定默认值表达式格式
• 保持开发环境与生产环境的定义一致性
• 在迁移前验证生成的 SQL 语句

理解 Atlas 的这种行为有助于开发者更好地规划数据库迁移策略，避免生成不必要的迁移脚本，同时确保数据库结构的正确性。