NextJS服务端组件调用Supabase路由处理器取数报错排查

核心问题所在 #

你遇到的两个问题本质是同一个原因：服务端组件内部调用API路由时，不会自动携带用户的Supabase认证Cookie。手动调用API时，浏览器会自动带上supabase-auth-token，所以路由里的Supabase客户端能识别用户；但服务器内部发起的请求没有这个Cookie上下文，导致：

1. Supabase查询因为没有用户身份，要么返回无权限的空结果，要么返回未过滤的多行数据，触发JSON object requested, multiple (or no) rows returned错误（大概率是你用了.single()但查询结果不满足单行要求）
2. supabase.auth.getUser()拿不到用户，因为没有认证凭证

具体修复步骤 #

1. 在服务端组件中手动传递认证Cookie给API #

服务端组件可以通过Next.js的cookies()函数拿到当前用户的Supabase Cookie，然后在fetch请求里把它加到请求头：

// app/YourServerComponent.tsx
import { cookies } from 'next/headers';

export default async function YourServerComponent() {
  const cookieStore = cookies();
  const authCookie = cookieStore.get('supabase-auth-token')?.value;

  // 调用API时带上Cookie
  const res = await fetch('/api/your-target-route', {
    headers: {
      Cookie: authCookie ? `supabase-auth-token=${authCookie}` : ''
    }
  });

  const data = await res.json();
  // 处理数据逻辑...
}

2. 确认路由处理器的Supabase客户端初始化正确 #

保证你的API路由里，createRouteHandlerSupabaseClient正确传入headers和cookies参数，这是它能从请求头里读取Cookie的关键：

// app/api/your-target-route/route.ts
import { createRouteHandlerSupabaseClient } from '@supabase/auth-helpers-nextjs';
import { headers, cookies } from 'next/headers';
import { Database } from '@/types/supabase';

export async function GET() {
  const supabase = createRouteHandlerSupabaseClient<Database>({
    headers,
    cookies
  });

  // 现在可以正常获取用户了
  const { data: { user }, error: authError } = await supabase.auth.getUser();
  if (authError || !user) {
    return Response.json({ error: '未授权访问' }, { status: 401 });
  }

  // 执行查询时必须用user.id过滤，确保返回符合预期的结果
  const { data, error } = await supabase
    .from('your_table')
    .select('*')
    .eq('user_id', user.id)
    .single(); // 只有确定返回单行时才用这个，否则直接去掉，返回数组

  if (error) {
    return Response.json({ error: error.message }, { status: 500 });
  }

  return Response.json(data);
}

3. 检查Supabase的RLS策略 #

如果还是有问题，确认你的表已经开启RLS，并且策略是基于用户ID过滤的，比如：

CREATE POLICY "仅允许用户访问自己的数据" ON your_table
FOR SELECT USING (auth.uid() = user_id);

4. 解决JSON object requested错误 #

这个错误是查询结果和你预期的格式不匹配：

• 如果预期返回单行：检查user_id过滤是否正确，表中是否确实只有一行属于该用户的数据
• 如果预期返回多行：直接删除.single()调用，让API返回数组即可

关键提醒 #

服务器内部的fetch请求和浏览器端的不一样，不会自动携带Cookie，必须手动传递。这是很多人在App目录下踩的坑，也是你这个问题的核心遗漏点。

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