在開(kāi)發(fā)高性能 Web 接口時(shí)，我們常常面臨這樣的問(wèn)題：

• 某些接口數(shù)據(jù)變化不頻繁，但訪問(wèn)量巨大；
• 某些操作（如排行榜、用戶信息）計(jì)算/查詢代價(jià)高昂；
• 數(shù)據(jù)庫(kù)訪問(wèn)壓力太大，接口響應(yīng)慢。

這時(shí)候，就輪到我們的大殺器——Redis 上場(chǎng)了。

本文帶你快速實(shí)戰(zhàn)：FastAPI 如何優(yōu)雅接入 Redis 實(shí)現(xiàn)緩存與存儲(chǔ)！

使用場(chǎng)景：接口緩存

我們以一個(gè)用戶信息接口為例：根據(jù) user_id 返回用戶數(shù)據(jù)，但用戶信息不常變動(dòng)，可以緩存。

安裝依賴

pip install fastapi uvicorn redis

初始化 Redis 客戶端

我們使用官方推薦的異步庫(kù) redis-py 配合 asyncio 實(shí)現(xiàn)異步訪問(wèn)。

# redis_client.py
import redis.asyncio as redis

redis_client = redis.Redis(
    host="localhost",
    port=6379,
    decode_responses=True  # 返回字符串而非字節(jié)
)

接口代碼示例

# main.py
from fastapi import FastAPI, HTTPException
from redis_client import redis_client
import json

app = FastAPI()


# 模擬數(shù)據(jù)庫(kù)
fake_user_db = {
    "1": {"id": 1, "name": "Alice"},
    "2": {"id": 2, "name": "Bob"},
}


@app.get("/user/{user_id}")
async def get_user(user_id: str):
    cache_key = f"user:{user_id}"

    # 嘗試從 Redis 獲取緩存
    cached_data = await redis_client.get(cache_key)
    if cached_data:
        return {"source": "redis", "data": json.loads(cached_data)}

    # 模擬從數(shù)據(jù)庫(kù)查詢
    user = fake_user_db.get(user_id)
    if not user:
        raise HTTPException(status_code=404, detail="用戶不存在")

    # 緩存結(jié)果，設(shè)置過(guò)期時(shí)間 60 秒
    await redis_client.set(cache_key, json.dumps(user), ex=60)

    return {"source": "db", "data": user}

說(shuō)明：

• Redis 作為緩存中間層：查詢接口先查 Redis，再查數(shù)據(jù)庫(kù)
• 緩存數(shù)據(jù)使用 JSON 序列化存儲(chǔ)
• 通過(guò) ex=60 設(shè)置緩存過(guò)期時(shí)間為 60 秒

Redis 的應(yīng)用價(jià)值

• 降低數(shù)據(jù)庫(kù)訪問(wèn)壓力
• 提升接口響應(yīng)速度（緩存命中幾乎毫秒級(jí)）
• 靈活設(shè)置過(guò)期時(shí)間，控制數(shù)據(jù)新鮮度

衍生應(yīng)用場(chǎng)景

• 用戶會(huì)話 token 存儲(chǔ)
• 短信驗(yàn)證碼防刷
• 排行榜數(shù)據(jù)緩存
• 秒殺庫(kù)存預(yù)扣減
• 實(shí)現(xiàn)消息隊(duì)列、分布式鎖等

小結(jié)

Redis 作為緩存方案在 FastAPI 項(xiàng)目中非常簡(jiǎn)單易用，也非常高效。它能幫助你：

• 提升接口性能；
• 減輕數(shù)據(jù)庫(kù)壓力；
• 實(shí)現(xiàn)更多靈活應(yīng)用場(chǎng)景（例如登錄狀態(tài)、驗(yàn)證碼、計(jì)數(shù)器等）。