SuperAPI AI 工具集

caching-strategy

编程与开发

查看项目

更新于 10-29 13:22

技能介绍

缓存策略(caching-strategy)是一份面向 Django 应用的缓存决策指南。其核心立场是:缓存是最后一步而非第一步。如果尚未运行性能审计,或者查询慢是因为 N+1 或缺少索引,应先修复这些问题;缓存一个糟糕的查询只会把问题隐藏到缓存变冷时。

用途 用于在 Django 项目里回答一组具体问题:这段数据是否值得缓存、应该缓存到哪一层、键怎么设计、TTL 设多长、写入后如何失效,以及如何避免把某个用户或组织的数据泄露给其他人。

判断是否值得缓存 资料给出的前提是三条同时成立:读取频率远高于变更频率;成本高(实测的慢查询、重聚合、外部 API 调用、复杂渲染);允许轻微陈旧,或能在每次写入时可靠失效。此外应向开发或 PRD 确认可接受的陈旧程度(“几秒”“直到下次写入”“一小时”),这个数字决定设计。

选择缓存层级 先检查 settings 中的 CACHES,明确后端(django-redis 或 Django 内置 RedisCache、memcached、LocMemCache)。LocMemCache 是进程内的,多 worker 场景下失效不会传播到其他进程,因此不要把它用于任何依赖写入失效的数据。 提供的对照包括:围绕函数的低层 cache.get_or_set,适合昂贵计算、查询结果、外部 API 响应,控制力最强,但键与失效由自己负责;@cache_page 或通过 method_decorator 使用 cache_page,适合公开、匿名、对所有人一致的页面或端点,按 URL 缓存,若为按用户响应且未 vary_on_headers("Authorization") 或 vary_on_cookie,会在用户间泄露;模板片段 {% cache %} 适合服务端渲染页面中开销大的部分,内容有差异时需把用户或组织纳入片段键;functools.cached_property 适合同一对象或同一请求内的重复工作,不跨请求共享;HTTP 缓存(ETag、Cache-Control、CDN)适合近似静态的公开 API 响应与文件,认证响应绝不能标记为 public。

键的设计 键应包含命名空间、版本,以及所有会改变结果的输入,例如 f"billing:v1:org:{org_id}:invoice_summary:{period}"。凡是按租户或用户限定的数据,键中必须带 org_id 或用户标识;缺少 org_id 的键就是数据泄露隐患。缓存值结构变化时提升版本前缀(v1 → v2),使部署后旧条目被忽略。较长的输入(过滤条件、查询参数)应做哈希而非原样放入键,因为 memcached 键上限为 250 字符。

失效策略 需选定一种并写在缓存代码旁边:仅 TTL,最简单,适合“最多陈旧 N 分钟”可接受的情况;写入时删除,在写入的服务函数中、事务提交后执行,例如使用 transaction.on_commit 调用 cache.delete,且应删除而非重新设置,让下次读取从已提交数据重建,优先放在服务层而不是 post_save 信号里,因为信号会漏掉 bulk_update 和 qs.update();版本化键,按组织存版本号并纳入键中,用 cache.incr 一次性失效该组织全部缓存。即便有显式失效,也应始终设置 TTL 作为兜底。

击穿与故障 热键在高负载下过期会导致大量 worker 同时重建,对昂贵重建可用短锁(如 cache.add(lock_key, 1, timeout=30))让只有一个 worker 重建,或给 TTL 加抖动。缓存不可用不应拖垮站点:某些后端下 Redis 错误会直接抛出,使用 django-redis 时可考虑 IGNORE_EXCEPTIONS,需确认实际配置。不要缓存上游调用失败产生的错误或空结果,或以极短 TTL 缓存。

记录与测试 建议在 PR 中写简短设计说明,包含缓存对象、层级、键、TTL、失效位置与陈旧容忍度。测试可用 LocMemCache 覆盖并在用例间清理,验证:第二次调用不再访问数据库(django_assert_num_queries(0));写入后失效(下次读取值改变);组织 A 永远看不到组织 B 的缓存值。

规则要点 绝不把按用户或组织的数据缓存在不含该标识的键下;绝不对认证端点使用 cache_page 而不按认证头或 cookie 变化;上线后尽量测量命中率,命中率低的缓存只是额外复杂度。

适用场景与限制 适用于 Django 后端的缓存设计与审查。资料未提供该技能的安装方式、依赖版本、运行命令或收费信息,这些内容暂未提供。