SuperAPI AI 工具集

managing-api-cache

部署与运维

查看项目

更新于 10-15 23:27

技能介绍

用途:为 API 实现智能响应缓存,支持 Redis、Memcached 或内存存储,并可与 CDN 边缘缓存配合,用于优化 API 性能。

主要能力:生成确定性缓存键(基于方法、路径、排序后的查询参数及相关请求头);实现 cache-aside 中间件,命中返回 X-Cache: HIT,未命中执行处理器后缓存并返回 X-Cache: MISS;按端点类别配置 TTL(参考数据 1 小时、频繁变化列表 5 分钟、近实时数据 30 秒);在 POST/PUT/DELETE 变更时按标签失效相关缓存;添加 Cache-Control、ETag、Last-Modified 响应头;支持 stale-while-revalidate 与缓存预热;支持 read-through、write-through、cache-aside 模式。

使用方式:需 Redis 6+ 或 Memcached(多实例部署必需),缓存客户端可用 ioredis、redis-py 或 Lettuce;可选支持 CloudFront、Cloudflare、Fastly 等 CDN。技能会分析端点可缓存性,输出缓存中间件、键生成器、失效器、存储抽象、策略配置与测试文件。

适用场景:产品目录列表与详情缓存、按用户缓存仪表盘数据、公共端点 CDN 边缘缓存等。

限制与错误处理:需监控命中率与驱逐率,并理解各端点数据新鲜度要求;需处理缓存击穿(锁式重验证、抖动 TTL)、失效遗漏、Redis 连接失败(降级到数据库)、键冲突与内存压力(allkeys-lru、键大小限制)。完整实现指南见技能目录下 references/implementation.md,错误模式见 references/errors.md。