调试指南

密码重置

• 症状：用户收不到密码重置邮件
• 根因：listUsers() 默认只返回 50 条，可能找不到目标用户
• 解决：使用 RPC 直接查 auth.users 表：supabase.rpc('get_user_by_email', { email })

会话管理

• 症状：登录后立即被登出
• 根因：Session token 过期或跨子域 Cookie 配置问题
• 解决：检查 sb-litopia-auth-token 存储——Web 用 Cookie（跨子域），Localhost/Capacitor/Tauri 用 localStorage

编辑器 chunk 错误

• 症状：编辑器加载时控制台报错 "Empty Error"
• 根因：编辑器 chunk 包含了 React 本身——在 BrowserRouter 外部使用了 useNavigate
• 解决：确保调用 useNavigate 的组件在 <BrowserRouter> 内部

PostgREST RPC 404

• 症状：调用 RPC 返回 404
• 根因：PostgREST schema 配置问题——RPC 函数需要在 API schema 中暴露
• 解决：确保 RPC 函数的 security definer 权限正确，且函数在 PostgREST 的 exposed schema 中