fastapi-cache：一个专给 FastAPI 做结果缓存的库！

fastapi-cache 是一个给 FastAPI 做结果缓存的库。它提供：

• 装饰器 @cache，能把路由或普通函数的返回结果缓存；

• 支持多种后端：Redis、Memcached、DynamoDB、内存；

• 支持 HTTP 缓存相关的头（ETag、Cache-Control），还能处理条件请求（If-None-Match），对前端缓存友好；

• 可定制编码器（coder）、key 生成器（key_builder）等，灵活度高。

总结一句话：把“逻辑 -> 响应”这段可重复利用的结果存到后端，下次直接读缓存，接口就快了。

解决了哪些痛点

• 减少重复数据库查询：热点数据、统计类接口、列表缓存都能显著降库压力；

• 降低计算成本：复杂计算或聚合结果可以缓存，节省 CPU；

• 提高响应速度：直接从 Redis/内存拿数据比走全链路快很多；

• 更友好的前端缓存支持：自动设置缓存相关头，配合浏览器或 CDN 更高效；

• 易用性：只要加个装饰器或初始化一次就能用，不用改大量业务代码。安装快上手

如果只是想立即试用：

• pip install fastapi-cache2如果你要用 Redis：

• pip install "fastapi-cache2[redis]"如果用 Memcached 或 DynamoDB：

• pip install "fastapi-cache2[memcache]"

• pip install "fastapi-cache2[dynamodb]"（注意：DynamoDB 后端还需要 aiobotocore 等依赖）

快速实战：最短路径上手

下面这段是常见的启动 + 装饰器示例（伪代码思路，用过就懂）：

• 在 FastAPI 启动时 init：

• FastAPICache.init(RedisBackend(redis_client), prefix="fastapi-cache")

• 在路由上直接用 @cache：

• @app.get("/")

@cache(expire=60)
async def index():

return {"hello": "world"}

这样，本接口的返回会被缓存 60 秒，命中时响应里会带上 X-FastAPI-Cache: HIT（默认），第一次是 MISS，然后后续直接从缓存返回。

后端注意点

• InMemoryBackend：只存在进程内，适合测试或单实例；不过内存缓存并不会主动清理过期数据，只有访问时才会发现过期并删除；

• RedisBackend：推荐生产使用，记得传一个不解码（decode_responses=False）的 Redis client，因为缓存的是二进制，解码会出问题；

• Memcached/DynamoDB：根据场景选（DynamoDB 适合 AWS 原生环境）。

优点

• 极易上手，代码改动很少；

• 支持多种后端，可平滑接入现有 infra（尤其 Redis）；

• 支持 HTTP 级别的缓存控制，能配合前端/CDN 做更大范围优化；

• 可定制化强（coder、key_builder），适用面广。缺点与注意事项

• 缓存一致性：写操作后需要手动清缓存或采用合适的过期策略，否则会读到旧数据；

• 内存后端不适合长久生产（单进程、没自动回收）；

• 序列化限制：默认 JsonCoder 对某些复杂类型支持有限，返回类型没标注时可能变成普通 JSON；

• 缓存键设计不当会造成缓存污染（比如把用户鉴权信息漏进 key 会引发安全问题）；

• 监控与运维：增加了 Redis 等组件依赖，需要监控缓存命中率、内存占用。

总结

fastapi-cache 是一把非常实用的“提速器”：对大多数 FastAPI 项目，特别是依赖数据库或复杂计算的读接口，接入成本低、效果直接。建议先在少量热点接口上试点，监测效果（响应时间、DB QPS、命中率），验证后逐步扩大覆盖。别忘了处理缓存一致性与序列化边界，这两点是长期可靠运行的关键。

以上就是“fastapi-cache：一个专给 FastAPI 做结果缓存的库！”的详细内容，想要了解更多Python教程欢迎持续关注编程学习网。