Drizzle ORM Upsert报错：无匹配ON CONFLICT的唯一约束问题

问题根源 #

你遇到的错误Drizzle: there is no unique or exclusion constraint matching the ON CONFLICT specification，本质是因为你创建的是基于lower(email)的函数唯一索引，而非email字段本身的唯一约束。当你在onConflictDoNothing中指定target: users.email时，PostgreSQL找不到对应的唯一约束——冲突检查的是lower(email)的唯一性，不是email字段本身。

同时你尝试用SQL表达式作为target的写法失败，是因为Drizzle的类型系统要求target接受列对象，而非原始SQL片段。

正确解决方案 #

在onConflictDoNothing中使用constraint参数，直接指定你定义的唯一索引名称（即user_email_unique_idx），这样就能匹配到基于lower(email)的函数索引。

修改后的Upsert代码 #

const [createdUser] = await tx
  .insert(users)
  .values({
    name: user.name,
    email: user.email,
    image: user.picture,
  })
  .onConflictDoNothing({
    constraint: "user_email_unique_idx", // 直接指定函数唯一索引的名称
  })
  .returning({
    slug: users.slug,
    id: users.id,
    email: users.email,
  });
console.log(createdUser);

扩展：针对slug的函数索引Upsert #

如果需要针对slug的函数唯一索引做同样的Upsert操作，只需把constraint的值换成user_slug_unique_idx即可：

.onConflictDoNothing({
  constraint: "user_slug_unique_idx",
})

原理说明 #

PostgreSQL允许在ON CONFLICT语句中通过约束/索引名称来指定冲突目标，Drizzle ORM的constraint参数正是对应这一特性。这种方式完美适配函数索引的场景，既绕过了类型限制，又能准确匹配到你定义的唯一约束逻辑。

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