Next.js集成Supabase注册失败：AuthRetryableFetchError 504排查求助

一、快速验证项 #

• 核对Supabase客户端配置：确认NEXT_PUBLIC_SUPABASE_URL和NEXT_PUBLIC_SUPABASE_ANON_KEY未被误修改，可在代码中临时打印变量值，或直接检查.env文件内容。
• 测试原始接口连通性：跳过Supabase JS客户端，直接用fetch调用注册接口：

  fetch(`${process.env.NEXT_PUBLIC_SUPABASE_URL}/auth/v1/signup`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'apikey': process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY
    },
    body: JSON.stringify({ email: 'test@example.com', password: 'test1234' })
  }).then(res => res.json()).then(console.log)
  

  若仍返回504，说明是网络/域名问题；若正常，则定位为JS客户端或代码逻辑问题。
• 跨环境测试：分别在本地开发环境和生产环境验证，确认是否仅单一环境异常。

二、客户端代码排查 #

• 回退Supabase JS版本：若近期升级过@supabase/supabase-js，回退到3天前正常使用的版本（如npm install @supabase/supabase-js@2.38.0），测试是否恢复。
• 检查请求拦截/代理规则：确认项目中无自定义fetch拦截器、Next.js rewrites/proxies配置篡改Auth接口路径或请求头。
• 严格校验参数格式：再次确认传入signUp的email为合法格式、password符合Supabase长度要求（默认≥6位），无多余非法参数混入。

三、网络/服务端排查 #

• 刷新DNS缓存：执行ipconfig /flushdns（Windows）或sudo dscacheutil -flushcache（Mac），排查域名解析异常。
• 测试服务器网络连通性：在生产服务器执行curl命令测试Supabase接口：

  curl -X POST "https://<你的项目ID>.supabase.co/auth/v1/signup" \
  -H "apikey: <你的ANON_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"email":"test@example.com","password":"test1234"}'
  

  若超时，检查服务器防火墙/云安全组是否封禁443端口，或Supabase IP是否被拉黑。
• 临时关闭CDN安全规则：若使用Cloudflare等CDN，关闭Bot Fight Mode等可能拦截请求的规则，测试是否恢复。

四、Supabase后台排查 #

• 检查资源使用限制：在Supabase后台「Usage」页面查看Auth请求次数，确认未超出免费版/付费版的请求上限。
• 核对Auth邮箱配置：虽手动添加用户正常，但可确认Auth的邮件模板、验证服务未被误配置（504虽非邮件问题，但排除潜在连锁影响）。

五、临时替代方案 #

• 改用Supabase REST API：直接调用接口绕过JS客户端，示例代码见「快速验证项」中的fetch示例。
• 排查Next.js API路由：若注册逻辑通过API路由转发，检查路由内是否存在阻塞操作导致请求超时。

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