使用AdonisJS Lucid的updateOrCreateMany()触发唯一键约束报错求助

问题重现 #

使用updateOrCreateMany()批量处理数据时触发数据库唯一约束错误：

duplicate key value violates unique constraint "my_table_github_id_unique"

代码示例：

const payload = [
  {
    githubId: anotherId,
    name: myName,
    status: myStatus,
  },
  // ... 其他数据项
]
// githubId 是数据库中唯一字段
await MyTable.updateOrCreateMany('githubId', payload)

而使用updateOrCreate()循环处理时无报错，但会产生大量数据库请求：

payload.forEach(async (item: any) => {
  const searchPayload = { githubId: item.githubId }
  await MyTable.updateOrCreate(searchPayload, item)
})

核心原因 #

updateOrCreateMany()的底层逻辑是批量插入+冲突更新，如果传入的payload数组内部存在重复的githubId值，批量插入阶段就会触发数据库的唯一约束校验直接报错——而循环调用updateOrCreate()时，每条数据单独处理，重复项会被后续的更新操作覆盖，不会触发批量插入的冲突。

解决方案 #

1. 先对payload去重 #

确保批量处理的数组中没有重复的githubId，可以用Map实现去重（保留最后出现的重复项）：

// 去重：以githubId为键，保留最后一个出现的项
const uniquePayload = Array.from(
  new Map(payload.map(item => [item.githubId, item])).values()
)

await MyTable.updateOrCreateMany('githubId', uniquePayload)

如果需要保留第一个出现的重复项，可以调整遍历顺序：

const uniquePayload = Array.from(
  new Map(payload.slice().reverse().map(item => [item.githubId, item])).values()
).reverse()

2. 确认数据库约束配置 #

确保githubId字段的唯一约束正确配置：

• 字段类型与代码中传入的githubId类型一致（比如都是字符串）
• 唯一约束是针对githubId字段的（即my_table_github_id_unique约束对应githubId）

补充说明 #

如果去重后仍报错，建议检查数据库中是否存在其他与githubId相关的复合唯一约束，或者尝试升级AdonisJS Lucid到最新稳定版排查已知逻辑bug。

内容的提问来源于stack exchange，提问作者fralps