Supabase 在 Next.js 中使用 Base Path 时的重定向问题解析

在基于 Next.js 框架开发的应用中，当使用 Supabase 进行用户认证时，配置基础路径（Base Path）可能会遇到一些重定向问题。本文将深入分析这一问题的成因，并提供解决方案。

问题背景

许多开发者在使用 Next.js 构建应用时，会为应用设置基础路径（如 /basepath）。这种配置在 Supabase 认证流程中可能导致以下问题：

1. 确认邮件中的链接不包含基础路径
2. 认证回调后用户被重定向到错误的 URL
3. 各种认证方式（OAuth、密码重置、魔法链接等）都受到影响

错误配置分析

常见的错误配置方式包括：

• 在 Supabase 仪表板中将 Site URL 设置为包含基础路径的完整 URL（如 https://example.com/basepath）
• 在重定向 URL 中也包含基础路径

这种配置会导致 Supabase 生成的认证链接无法正确处理基础路径，从而引发重定向问题。

正确配置方案

经过实践验证，正确的配置方法应该是：

1. 在 Supabase 仪表板中：

   • Site URL 应设置为根域名（如 https://example.com）
   • 重定向 URL 也应设置为根域名（如 https://example.com/auth/callback）

2. 在 Next.js 应用中：

   • 通过环境变量管理基础路径
   • 在回调处理中动态添加基础路径

回调处理实现

以下是一个经过优化的回调处理代码示例：

import { NextResponse } from 'next/server'
import { createClient } from '@repo/supabase/server'

export async function GET(request: Request) {
  const { searchParams, origin } = new URL(request.url)
  const code = searchParams.get('code')
  const next = searchParams.get('next') ?? '/'

  if (code) {
    const supabase = await createClient()
    const { error } = await supabase.auth.exchangeCodeForSession(code)

    if (!error) {
      // 处理不同环境下的重定向
      const forwardedHost = request.headers.get('x-forwarded-host')
      const isLocalEnv = process.env.NODE_ENV === 'development'
      
      let redirectUrl = ''
      if (isLocalEnv) {
        redirectUrl = `${origin}${process.env.BASEPATH}${next}`
      } else if (forwardedHost) {
        redirectUrl = `https://${forwardedHost}${process.env.BASEPATH}${next}`
      } else {
        redirectUrl = `${origin}${process.env.BASEPATH}${next}`
      }
      
      return NextResponse.redirect(redirectUrl)
    }
  }

  return NextResponse.redirect(`${origin}/auth/error`)
}

进阶问题：网络配置

当应用部署在网络服务后面时（如 Vercel 部署但使用自定义域名），还需要注意：

1. 检查请求头中的 x-forwarded-host 信息
2. 确保网络服务正确传递原始主机信息
3. 在不同环境（开发、测试、生产）中测试重定向行为

最佳实践建议

1. 保持 Supabase 配置简洁，避免在 Site URL 中包含路径
2. 使用环境变量管理基础路径
3. 实现完善的错误处理机制
4. 在不同部署环境下充分测试认证流程
5. 对于复杂场景，考虑使用中间件统一处理路径转换

通过遵循这些指导原则，开发者可以避免大多数与基础路径相关的认证问题，确保用户在各种认证流程中都能被正确重定向。