后端 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 反向代理会把流式输出攒满缓冲区才一次性吐给浏览器,导致“假卡死”。