Next.js 14/Supabase应用邮箱验证报错：Database error finding user from email link

可能的原因及解决方案 #

1. OTP类型参数不匹配 #

你的邮箱验证链接里指定的type=email，但Supabase注册流程的邮箱验证对应的OTP类型应该是signup（email类型多用于密码重置场景），类型不匹配会导致系统无法找到对应的注册用户记录。

修复步骤：

• 修改Supabase邮箱模板中的验证链接，将type=email改为type=signup：

  {{ .SiteURL }}/auth/confirm?token_hash={{.TokenHash}}&type=signup&next={{.SiteURL}}/projects
  

• 更新assertOtpType函数，允许signup类型：

  function assertOtpType(type: string): EmailOtpType {
    if (!["email", "signup"].includes(type)) {
      throw new Error("Invalid OTP type")
    }
    return type as EmailOtpType
  }
  

2. 服务器端Supabase客户端配置不完整 #

检查createServerClient的导入和cookies配置，缺失必要的cookie属性（如secure、sameSite）会导致会话无法正确建立，进而触发用户查找失败。

修复步骤：

• 确保正确导入Supabase官方的服务器端客户端：

  import { createServerClient } from '@supabase/auth-helpers-nextjs'
  

• 完善cookies配置，适配生产环境的安全要求：

  const supabase = createServerClient(
    process.env.NEXT_PUBLIC_SUPABASE_URL!,
    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
    {
      cookies: {
        get(name) {
          return cookieStore.get(name)?.value
        },
        set(name, value, options) {
          cookieStore.set({
            name,
            value,
            ...options,
            secure: process.env.NODE_ENV === 'production',
            sameSite: 'lax'
          })
        },
        remove(name, options) {
          cookieStore.set({
            name,
            value: '',
            ...options,
            secure: process.env.NODE_ENV === 'production',
            sameSite: 'lax'
          })
        },
      },
    },
  )
  

3. next参数未URL编码 #

邮箱模板中直接拼接next={{.SiteURL}}/projects，未进行URL编码会导致链接参数解析异常，干扰验证流程的参数传递。

修复步骤：

• 修改邮箱模板，对next参数进行URL编码：

  {{ .SiteURL }}/auth/confirm?token_hash={{.TokenHash}}&type=signup&next={{ urlencode (printf "%s/projects" .SiteURL) }}
  

4. 验证后未确认会话状态 #

OTP验证成功后直接跳转，可能存在会话未完全建立的情况，导致后续页面无法识别用户。

修复步骤：

• 在验证成功后，先确认用户会话已建立再跳转：

  if (token_hash && type) {
    const { error } = await supabase.auth.verifyOtp({
      type: assertOtpType(type),
      token_hash,
    })
    console.log({ error })
    if (!error) {
      // 确认用户会话已创建
      const { data: { user } } = await supabase.auth.getUser()
      if (user) {
        return NextResponse.redirect(next!)
      }
    }
  }
  

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