backend-server

后端服务开发

方案选型

方案	语言	适合场景	免费额度	学习成本
Supabase	SQL + TypeScript	快速出产品、CRUD 为主	500MB 数据库 + 1GB 存储	低
Cloudflare Workers	TypeScript	轻量 API、全球加速	10 万请求/天	中
Vapor	Swift	Swift 全栈、共享 Model	需自备服务器	高
Firebase	TypeScript / Dart	Google 生态、实时同步	Spark 计划免费	中

选择原则：

• 独立开发者首选 Supabase（开箱即用，PostgreSQL + RLS 天然适合移动端）
• 追求极致轻量和全球边缘部署选 Cloudflare Workers
• 想前后端共享 Swift 代码选 Vapor
• 已在 Google 生态内选 Firebase

---

Supabase 规范

项目初始化

npx supabase init
npx supabase login
npx supabase link --project-ref <project-id>

数据库 & RLS

• 所有业务表必须启用 RLS，禁止 public schema 表无策略暴露
• 策略命名：{操作}_{表名}_{角色}，如 select_profiles_authenticated
• 禁止在策略中使用 true（即允许所有访问），必须明确条件：

-- ✅ 正确：只允许用户访问自己的数据
CREATE POLICY select_profiles_authenticated ON profiles
  FOR SELECT TO authenticated
  USING (auth.uid() = user_id);

-- ❌ 禁止：允许所有人访问
CREATE POLICY select_profiles ON profiles
  FOR SELECT USING (true);

• 视图必须设置 security_invoker = true：

CREATE VIEW public.user_stats WITH (security_invoker = true) AS
  SELECT * FROM stats WHERE user_id = auth.uid();

• 禁止暴露 service_role key 到客户端，仅限服务端 / Edge Functions 使用

Edge Functions

• 函数放在 supabase/functions/ 目录，每个函数一个子目录
• 命名：kebab-case，如 send-push-notification
• 必须验证用户身份：

import { createClient } from 'https://esm.sh/@supabase/supabase-js@2'

Deno.serve(async (req) => {
  const authHeader = req.headers.get('Authorization')
  if (!authHeader) {
    return new Response(JSON.stringify({ error: 'Unauthorized' }), { status: 401 })
  }

  const supabase = createClient(
    Deno.env.get('SUPABASE_URL') ?? '',
    Deno.env.get('SUPABASE_ANON_KEY') ?? '',
    { global: { headers: { Authorization: authHeader } } }
  )

  const { data: { user } } = await supabase.auth.getUser()
  if (!user) {
    return new Response(JSON.stringify({ error: 'Invalid token' }), { status: 401 })
  }

  // 业务逻辑...
})