99 lines
2.6 KiB
Markdown
99 lines
2.6 KiB
Markdown
|
# 问题排查
|
|||
|
|
|
|||
|
|
## CLI 命令问题
|
|||
|
|
|
|||
|
|
### 命令执行规则
|
|||
|
|
1. **独立执行**：每个 CLI 命令必须单独调用，等待结果后再继续
|
|||
|
|
2. **确认等待**：启用云服务时会弹出确认卡片，必须等待用户确认完成
|
|||
|
|
|
|||
|
|
## 数据库问题
|
|||
|
|
|
|||
|
|
### 数据看不到
|
|||
|
|
通常是 RLS 策略与实际功能不匹配：
|
|||
|
|
- 如果应用没有登录功能，使用匿名友好策略：`USING (true)`
|
|||
|
|
- 如果应用有登录功能，确保策略正确使用 `auth.uid()`
|
|||
|
|
|
|||
|
|
### RLS 违规错误
|
|||
|
|
插入数据时出现"违反行级安全"：
|
|||
|
|
- 确保 `user_id` 字段在 INSERT 时正确设置为 `auth.uid()`
|
|||
|
|
- 确保 `user_id` 字段不是 nullable（如果 RLS 策略依赖它）
|
|||
|
|
|
|||
|
|
### 无限递归错误
|
|||
|
|
RLS 策略直接引用同一表：
|
|||
|
|
```sql
|
|||
|
|
-- ❌ 会导致无限递归
|
|||
|
|
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'));
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 认证问题
|
|||
|
|
|
|||
|
|
### 认证状态监听死锁
|
|||
|
|
```typescript
|
|||
|
|
-- ❌ 错误：会导致死锁
|
|||
|
|
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：
|
|||
|
|
```typescript
|
|||
|
|
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 处理：
|
|||
|
|
```typescript
|
|||
|
|
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 行，使用分页：
|
|||
|
|
```typescript
|
|||
|
|
const { data } = await supabase
|
|||
|
|
.from('posts')
|
|||
|
|
.select()
|
|||
|
|
.range(0, 49); // 前50条
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 单行查询错误
|
|||
|
|
```typescript
|
|||
|
|
// ✅ 安全
|
|||
|
|
const { data } = await supabase.from('table').select().eq('id', id).maybeSingle();
|
|||
|
|
|
|||
|
|
// ❌ 可能出错
|
|||
|
|
const { data } = await supabase.from('table').select().eq('id', id).single();
|
|||
|
|
```
|