Kysely项目中PostgreSQL自增ID的两种生成方式对比

在Kysely ORM框架与PostgreSQL数据库的集成开发中，处理自增ID字段是一个常见需求。PostgreSQL提供了两种不同的自增ID生成方式，开发者需要根据实际场景选择合适的策略。

GENERATED ALWAYS与GENERATED BY DEFAULT的区别

PostgreSQL的IDENTITY列支持两种生成模式：

1. GENERATED ALWAYS模式

   • 严格禁止手动插入ID值
   • 系统始终自动生成ID
   • 适用于严格要求ID由数据库控制的场景
   • 若尝试手动插入会抛出错误

2. GENERATED BY DEFAULT模式

   • 允许手动指定ID值
   • 仅在未提供ID值时自动生成
   • 适用于需要导入已有数据或特殊ID分配的场景

Kysely中的实践建议

在使用Kysely定义表结构时，应该根据业务需求选择合适的ID生成策略：

• 对于全新系统且不需要维护历史数据的情况，使用GENERATED ALWAYS可以确保ID生成的完全控制
• 对于需要数据迁移或特殊ID分配的场景，GENERATED BY DEFAULT提供了更大的灵活性

常见问题解决方案

当遇到"cannot insert a non-DEFAULT value into column"错误时，可以采取以下解决方案：

1. 修改DDL语句，将GENERATED ALWAYS改为GENERATED BY DEFAULT
2. 在插入数据时确保不包含ID字段，让数据库自动生成
3. 如果必须使用GENERATED ALWAYS但又需要指定ID，可以使用PostgreSQL的OVERRIDING SYSTEM VALUE语法（但Kysely目前未直接提供此API）

最佳实践

1. 在开发环境使用GENERATED BY DEFAULT方便测试数据导入
2. 生产环境考虑使用GENERATED ALWAYS确保数据一致性
3. 使用TypeScript接口明确定义表结构，如示例中的FleetTable接口
4. 通过Kysely的类型系统(Selectable, Insertable, Updateable)确保类型安全

理解这两种ID生成方式的区别，可以帮助开发者在Kysely项目中做出更合理的设计决策，避免在数据迁移和系统集成时遇到问题。