Supabase+NextJS：判断用户行是否存在并插入逻辑失效排查

你的查询语句语法本身没问题，但查不到已存在用户大概率是行级安全（RLS）规则限制或数据权限/类型不匹配导致的，以下是具体排查和修复方案：

1. 检查Supabase行级安全（RLS）规则 #

默认情况下，若users表开启了RLS，可能未配置允许认证用户查询自身数据的规则。前往Supabase控制台操作：

• 进入users表 → 点击「行级安全」标签
• 若没有SELECT权限规则，添加以下SQL规则：

  CREATE POLICY "Authenticated users can view their own profile" ON public.users
  FOR SELECT USING (auth.uid() = id);
  

  该规则仅允许已认证用户查询自己的行，符合前端客户端最小权限原则。

2. 优化查询逻辑并添加错误处理 #

原查询返回数组，建议用.single()简化判断（因id是唯一键，最多返回一条数据），同时捕获错误避免静默失败：

useEffect(() => {
  const getUser = async () => {
    const { data: { user }, error: authError } = await supabase.auth.getUser();
    if (authError) {
      console.error("获取认证用户失败:", authError);
      return;
    }
    setUser(user);

    if (!user?.id) return;

    // 查询用户是否存在，用single()直接返回单个对象或null
    const { data: existingUser, error: queryError } = await supabase
      .from("users")
      .select("id")
      .eq("id", user.id)
      .single();

    if (queryError) {
      // 仅当错误为"找不到行"时继续，其他错误打印日志
      if (queryError.code !== "PGRST116") {
        console.error("查询用户失败:", queryError);
        return;
      }
    }

    if (!existingUser) {
      const { data: insertedUser, error: insertError } = await supabase.from("users").insert({
        id: user.id,
        domainConnect: false,
        email: user.email,
        isPremium: false,
        sites: [],
      });
      insertError ? console.error("插入用户失败:", insertError) : console.log("用户创建成功:", insertedUser);
    }
  };

  getUser();
}, []);

3. 用upsert彻底避免重复插入错误 #

如果不需要复杂的查询判断，直接用upsert替代insert，它会自动处理「存在则更新，不存在则插入」的逻辑（指定id为冲突判断字段）：

// 替换原insert逻辑
const { data, error } = await supabase.from("users").upsert({
  id: user.id,
  domainConnect: false,
  email: user.email,
  isPremium: false,
  sites: [],
}, { onConflict: "id" });

4. 检查表结构匹配 #

确认users表的id字段类型为UUID（与Supabase auth用户的id类型一致），且已设置为主键。若为VARCHAR类型，需确保存储的id与user.id完全一致（无大小写、空格差异）。

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