如何在Supabase开启邮箱确认时检查用户是否已存在？

当开启*Enable email confirmations（邮箱确认）*时，Supabase会返回模糊化/虚假的用户对象，无法直接通过注册接口判断邮箱是否已存在。以下是几种不关闭邮箱确认的前提下的解决方案：

方法一：查询auth.users表（推荐） #

通过后端服务使用Supabase服务角色密钥查询auth.users表，需先确保该表的RLS策略允许服务角色访问邮箱字段：

// 后端环境示例（Node.js，需使用服务角色密钥初始化supabaseAdmin）
const { data, error } = await supabaseAdmin
  .from('auth.users')
  .select('id')
  .eq('email', 'target@example.com')
  .single()

if (error) {
  // 邮箱不存在或查询出错
  console.log('邮箱未注册或查询失败:', error)
} else {
  // 邮箱已存在
  console.log('邮箱已注册')
}

注意：禁止在前端使用服务角色密钥，必须通过自有后端接口中转查询，避免泄露敏感信息。

方法二：使用listUsers API #

在后端使用服务角色密钥调用listUsers接口，通过邮箱过滤用户：

const { data, error } = await supabaseAdmin.auth.api.listUsers({
  email: 'target@example.com'
})

if (error) {
  // 处理查询错误
} else {
  const emailExists = data.users.length > 0
  console.log(emailExists ? '邮箱已存在' : '邮箱未注册')
}

方法三：前端间接判断（不推荐） #

尝试用目标邮箱发起注册请求，根据返回的错误信息判断：

• 若邮箱已存在且未确认，会返回类似User already registered的错误
• 若邮箱已存在且已确认，会返回类似Email already in use的错误
  此方法会触发邮箱验证邮件发送，用户体验较差，仅作为应急方案使用。

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