iloom-flatten/skills/meoo-cloud/references/troubleshooting.md

问题排查

CLI 命令问题

命令执行规则

1. 独立执行：每个 CLI 命令必须单独调用，等待结果后再继续
2. 确认等待：启用云服务时会弹出确认卡片，必须等待用户确认完成

数据库问题

数据看不到

通常是 RLS 策略与实际功能不匹配：

• 如果应用没有登录功能，使用匿名友好策略：USING (true)
• 如果应用有登录功能，确保策略正确使用 auth.uid()

RLS 违规错误

插入数据时出现"违反行级安全"：

• 确保 user_id 字段在 INSERT 时正确设置为 auth.uid()
• 确保 user_id 字段不是 nullable（如果 RLS 策略依赖它）

无限递归错误

RLS 策略直接引用同一表：

-- ❌ 会导致无限递归
CREATE POLICY "example" ON profiles
FOR SELECT USING ((SELECT role FROM profiles WHERE id = auth.uid()) = 'admin');

-- ✅ 使用安全定义函数
CREATE POLICY "example" ON profiles
FOR SELECT USING (public.has_role(auth.uid(), 'admin'));

认证问题

认证状态监听死锁

-- ❌ 错误：会导致死锁
supabase.auth.onAuthStateChange(async (event, session) => {
  const profile = await supabase.from('profiles').select()... // 死锁
});

-- ✅ 正确：延迟 Supabase 调用
supabase.auth.onAuthStateChange((event, session) => {
  setSession(session);
  if (session?.user) {
    setTimeout(() => fetchUserProfile(session.user.id), 0);
  }
});

存储问题

文件上传 400 错误

必须使用 ArrayBuffer，不能使用 Blob/File/FormData：

import { decode } from 'base64-arraybuffer';

// ✅ 正确
await supabase.storage.from('bucket').upload('path', decode(base64));

// ❌ 错误
await supabase.storage.from('bucket').upload('path', file); // 400 错误

Edge Functions 问题

CORS 错误

确保函数包含 CORS 处理：

if (req.method === 'OPTIONS') {
  return new Response('ok', {
    headers: {
      'Access-Control-Allow-Origin': '*',
      'Access-Control-Allow-Methods': 'POST, GET, OPTIONS',
      'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
    },
  });
}

查询问题

查询限制

Supabase 默认限制 1000 行，使用分页：

const { data } = await supabase
  .from('posts')
  .select()
  .range(0, 49); // 前50条

单行查询错误

// ✅ 安全
const { data } = await supabase.from('table').select().eq('id', id).maybeSingle();

// ❌ 可能出错
const { data } = await supabase.from('table').select().eq('id', id).single();