PayloadCMS中如何为PostgreSQL设置自定义UUID主键

在PayloadCMS项目中，当使用PostgreSQL作为数据库时，默认情况下系统会自动生成UUID作为主键。但在某些场景下，开发者可能需要手动指定这些主键值，特别是在数据迁移或初始化种子数据时。

问题背景

PayloadCMS的PostgreSQL数据库适配器默认会忽略创建操作中传入的ID值，自动生成新的UUID。这种行为在大多数情况下是合理的，但在需要精确控制主键值的场景下就显得不够灵活。

解决方案

从PayloadCMS 3.29.0版本开始，PostgreSQL适配器新增了一个配置选项allowIDOnCreate，专门用于解决这个问题。开发者可以通过以下步骤启用自定义主键功能：

1. 确保项目使用的是PayloadCMS 3.29.0或更高版本
2. 在数据库配置中添加allowIDOnCreate: true选项

配置示例

import { buildConfig } from 'payload/config'
import { postgresAdapter } from '@payloadcms/db-postgres'

export default buildConfig({
  db: postgresAdapter({
    poolOptions: {
      connectionString: process.env.DATABASE_URI,
    },
    allowIDOnCreate: true, // 启用自定义ID功能
  }),
  // 其他配置...
})

使用场景

启用此功能后，开发者可以在种子数据脚本中直接指定主键值：

await payload.create({
  collection: 'posts',
  data: {
    id: "550e8400-e29b-41d4-a716-446655440000", // 自定义UUID
    title: "示例文章",
    content: "这是示例内容"
  }
})

注意事项

1. 确保传入的UUID格式正确
2. 避免主键冲突，特别是在已有数据的情况下
3. 此功能仅适用于PostgreSQL数据库
4. 在生产环境中使用时，建议配合事务处理以确保数据一致性

通过这种方式，PayloadCMS项目可以更灵活地控制数据库主键，满足各种特殊业务场景的需求。