FastAPI + Redis 實(shí)戰(zhàn)：一分鐘搞定高性能緩存方案
作者：Ss肥魚
本文帶你快速實(shí)戰(zhàn)：FastAPI 如何優(yōu)雅接入 Redis 實(shí)現(xiàn)緩存與存儲！
在開發(fā)高性能 Web 接口時，我們常常面臨這樣的問題：
- 某些接口數(shù)據(jù)變化不頻繁，但訪問量巨大；
- 某些操作（如排行榜、用戶信息）計算/查詢代價高昂；
- 數(shù)據(jù)庫訪問壓力太大，接口響應(yīng)慢。
這時候，就輪到我們的大殺器——Redis 上場了。
本文帶你快速實(shí)戰(zhàn)：FastAPI 如何優(yōu)雅接入 Redis 實(shí)現(xiàn)緩存與存儲！
使用場景：接口緩存
我們以一個用戶信息接口為例：根據(jù) user_id 返回用戶數(shù)據(jù)，但用戶信息不常變動，可以緩存。
安裝依賴
pip install fastapi uvicorn redis初始化 Redis 客戶端
我們使用官方推薦的異步庫 redis-py 配合 asyncio 實(shí)現(xià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ù)庫
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ù)庫查詢
user = fake_user_db.get(user_id)
if not user:
raise HTTPException(status_code=404, detail="用戶不存在")
# 緩存結(jié)果，設(shè)置過期時間 60 秒
await redis_client.set(cache_key, json.dumps(user), ex=60)
return {"source": "db", "data": user}說明：
- Redis 作為緩存中間層：查詢接口先查 Redis，再查數(shù)據(jù)庫
- 緩存數(shù)據(jù)使用 JSON 序列化存儲
- 通過 ex=60 設(shè)置緩存過期時間為 60 秒
Redis 的應(yīng)用價值
- 降低數(shù)據(jù)庫訪問壓力
- 提升接口響應(yīng)速度（緩存命中幾乎毫秒級）
- 靈活設(shè)置過期時間，控制數(shù)據(jù)新鮮度
衍生應(yīng)用場景
- 用戶會話 token 存儲
- 短信驗證碼防刷
- 排行榜數(shù)據(jù)緩存
- 秒殺庫存預(yù)扣減
- 實(shí)現(xiàn)消息隊列、分布式鎖等
小結(jié)
Redis 作為緩存方案在 FastAPI 項目中非常簡單易用，也非常高效。它能幫助你：
- 提升接口性能；
- 減輕數(shù)據(jù)庫壓力；
- 實(shí)現(xiàn)更多靈活應(yīng)用場景（例如登錄狀態(tài)、驗證碼、計數(shù)器等）。
責(zé)任編輯：趙寧寧
來源：
Ssoul肥魚
