VibeCraft Vibe Coding 实战指南
API 架构 SQLite / Postgres SSE 流式输出

后端 API、数据库建模与流式响应实战

后端稳不稳,看三件事:数据校验是否严格、数据库变更是否可重复执行、长耗时 AI 请求会不会阻塞主线程。

1. SQLite vs PostgreSQL 怎么选?

对比项SQLite(配合 WAL 模式)PostgreSQL
适用阶段个人工具、日活数千以内 SaaS、本地桌面/单机容器多机横向扩展、高并发写入、复杂全文检索或向量检索
运维成本极低,一个 .db 文件搞定备份(直接复制文件)需要独立容器或托管数据库服务
必做优化连接时开启 PRAGMA journal_mode=WAL; 防止并发锁库配置连接池大小与索引监控

2. 幂等数据库初始化与平滑加字段模板

用 Vibe Coding 迭代项目时,数据库经常今天加一列、明天加一张表。用下面这种幂等迁移写法,重启一百次也不会报错:

import sqlite3

def init_db(db_path: str = "./data/app.db"):
    conn = sqlite3.connect(db_path)
    conn.execute("PRAGMA journal_mode=WAL;")
    conn.execute("PRAGMA foreign_keys=ON;")
    conn.execute('''
        CREATE TABLE IF NOT EXISTS bookmarks (
            id INTEGER PRIMARY KEY AUTOINCREMENT,
            user_id INTEGER NOT NULL,
            url TEXT NOT NULL,
            title TEXT NOT NULL,
            summary TEXT DEFAULT '',
            tags TEXT DEFAULT '[]',
            created_at TEXT DEFAULT CURRENT_TIMESTAMP
        )
    ''')
    # 检查后续迭代新增的列是否存在,不存在再安全追加
    cols = {r[1] for r in conn.execute("PRAGMA table_info(bookmarks)").fetchall()}
    if "is_archived" not in cols:
        conn.execute("ALTER TABLE bookmarks ADD COLUMN is_archived INTEGER DEFAULT 0")
    conn.commit()
    conn.close()

3. 登录鉴权:优先用 HttpOnly Cookie 而非 localStorage

常见安全坑

AI 默认最喜欢把 JWT Token 存到浏览器 localStorage,一旦网页存在任何 XSS 注入,黑客一行 JS 就能把 Token 偷走。生产项目尽量要求 AI 使用 HttpOnly + SameSite=Lax + Secure Cookie 传递登录态。

4. 做 AI 应用必学:SSE 流式输出模板(FastAPI)

调用大模型生成内容往往要 5–20 秒,如果让普通 JSON 接口干等,用户会以为卡死了而且容易触发 Nginx 60s 超时。标准解法是使用 Server-Sent Events (SSE) 边生成边吐字:

from fastapi import FastAPI
from fastapi.responses import StreamingResponse
import asyncio, json

app = FastAPI()

@app.get("/api/chat/stream")
async def stream_answer(prompt: str):
    async def event_gen():
        # 示例:模拟向前端逐块推送 Token
        for chunk in ["正在检索资料...", "梳理要点中:", "Vibe Coding 的核心在于小步闭环。"]:
            payload = json.dumps({"delta": chunk}, ensure_ascii=False)
            yield f"data: {payload}\n\n"
            await asyncio.sleep(0.35)
        yield "data: [DONE]\n\n"

    return StreamingResponse(
        event_gen(),
        media_type="text/event-stream",
        headers={"Cache-Control": "no-cache", "X-Accel-Buffering": "no"}
    )

注意上面响应头里的 X-Accel-Buffering: no——少了这一行,线上 Nginx 反向代理会把流式输出攒满缓冲区才一次性吐给浏览器,导致“假卡死”。