跨平台开发 / 系统课时
给缓存数据设置过期策略
给缓存数据设置过期策略
缓存不是“有值就能用”。本篇把缓存可用性判断拆成三类条件:时间戳控制新鲜度、版本号控制结构或数据代际、业务条件控制特定状态;读取前统一判定,避免把过期数据继续返回给页面。
学习目标
- 使用保存时间和 TTL 判断缓存是否过期
- 用版本号处理缓存结构或数据版本变化
- 把业务失效条件纳入统一的缓存判定流程
先定义缓存可用性的规则
最常见的是 TTL,也就是“保存后多久仍算新鲜”。如果缓存保存时间为 savedAt,允许存活时长为 ttl,那么当前时间超过 savedAt + ttl 时就应视为过期。
版本号解决的是另一类问题:即使时间还没到,应用升级后缓存结构已经变化,或者服务端已经切换到新数据版本,也不应继续使用旧缓存。业务条件则用于表达“状态一变就立即失效”,例如购物车结算完成后,无论缓存保存了多久,都应重新拉取。

用一个模型统一判断是否可用
不要把 TTL、版本号和业务条件散落在多个页面。下面的 Dart 示例把判定集中到 CacheEntry.isUsable,调用者只需要关心最终布尔结果。
class CacheEntry<T> {
final T value;
final DateTime savedAt;
final int version;
final bool businessValid;
const CacheEntry({
required this.value,
required this.savedAt,
required this.version,
required this.businessValid,
});
bool isUsable({
required DateTime now,
required Duration ttl,
required int expectedVersion,
}) {
final expired = now.isAfter(savedAt.add(ttl));
// 三类条件任一不满足,都把缓存视为不可用。
return !expired &&
version == expectedVersion &&
businessValid;
}
}
void main() {
final entry = CacheEntry<String>(
value: 'cached-profile',
savedAt: DateTime.utc(2026, 9, 16, 1, 0),
version: 3,
businessValid: true,
);
final usable = entry.isUsable(
now: DateTime.utc(2026, 9, 16, 1, 20),
ttl: const Duration(minutes: 30),
expectedVersion: 3,
);
print('usable=$usable');
print("value=${usable ? entry.value : 'fetch-network'}");
}预期输出:
usable=true
value=cached-profile把 now 改到 01:31 之后、把 expectedVersion 改为 4,或把 businessValid 改为 false,都会得到不可用结果。真实项目不要依赖可被用户手动调整的本地时间去保护安全敏感数据;TTL 主要用于数据新鲜度控制。
三种过期条件怎么组合
时间戳适合“过一段时间再刷新”的数据,例如新闻列表和商品详情;版本号适合缓存结构升级、接口字段变更或整批数据换代;业务条件适合“事件发生后立即失效”的场景,例如退出登录后清理用户缓存。
它们通常采用“任一失败即失效”的组合,而不是互相替代。这样即使 TTL 还没到,版本变化也能立即淘汰旧数据;即使版本一致,业务状态失效也不会误用缓存。
失效后要做什么
判断为过期后,通常有两种处理方式:立即删除缓存,或者保留旧值但标记为不可直接使用。前者简单,适合体积小且重新获取成本低的数据;后者适合“网络失败时允许展示旧数据并明确提示”的产品策略。
如果选择保留旧值,Repository 必须区分“新鲜缓存”和“过期缓存”,不能让普通读取路径误把旧值当成有效值。网络请求成功后,应同时写入新数据、当前保存时间和最新版本号,形成下一次判断所需的完整元数据。
缓存过期策略的关键不是选一个固定 TTL,而是把“时间、版本、业务状态”变成可测试的明确规则;只有规则通过时,缓存才有资格参与读取。