用 @cache.cached 可缓存视图函数返回值,需先初始化 cache 实例并调用 init_app;支持 timeout 和 key_prefix 控制缓存时长与键前缀,自定义 make_cache_key 精细控制缓存粒度;清除缓存需用 cache.delete 或 cache.clear,避免数据不一致。

缓存视图函数返回值:用 @cache.cached 最直接
Flask 默认不带缓存能力,得靠 Flask-Caching 扩展。缓存一个视图函数,核心就是加装饰器 @cache.cached,它会把函数返回的响应内容(HTML、JSON 等)序列化后存进后端(如 Redis、Memcached 或本地内存)。
常见错误是直接装饰函数但没初始化 cache 实例,或者忘了在应用工厂里调用 cache.init_app(app),结果运行时报 AttributeError: 'Cache' object has no attribute 'app'。
- 必须先创建
cache = Cache(),再在create_app()里调用cache.init_app(app, config=...) -
@cache.cached(timeout=300)表示缓存 5 分钟;设为timeout=None则永不过期(慎用) - 如果视图函数带参数(比如
/user/<user_id></user_id>),默认会按完整请求 URL 缓存,不同user_id互不干扰 - 注意:
@cache.cached缓存的是视图函数的 返回值,不是渲染后的响应对象;它对return jsonify(...)和return render_template(...)都有效
缓存键怎么控制:用 key_prefix 和自定义 make_cache_key
默认缓存键是请求路径 + 查询参数(如 /api/data?sort=desc),但有时需要更精细控制——比如忽略某个查询参数,或强制让多个路由共用一个缓存项。
典型场景:分页接口 /items?page=1 和 /items?page=2 不该共享缓存,但 /items?format=json 和 /items?format=xml 可能返回相同数据,却因参数不同被存两份。
- 用
@cache.cached(key_prefix='items_list')可统一前缀,避免路径变动影响命中 - 更灵活的做法是传入函数:
@cache.cached(make_cache_key=lambda: request.args.get('category', 'all')),只按分类缓存 - 别直接拼字符串做 key,
Flask-Caching内部会对 key 做哈希和编码,传原始值即可 - 如果用了自定义
make_cache_key,它必须返回一个字符串或字节串,且不能依赖未初始化的上下文(比如在请求外调用会报RuntimeError: Working outside of application context)
缓存失效怎么做:手动 cache.delete_memoized() 或 cache.clear()
缓存不是设了就完事,数据更新时得主动踢掉旧缓存,否则用户看到的就是过期内容。最常用的是按函数名清除——前提是那个函数确实被 @cache.memoize 或 @cache.cached 装饰过。
注意:@cache.cached 装饰的视图函数,不能用 cache.delete_memoized(func) 清除,得用 cache.delete(key) 或重新生成 key 后删;而 @cache.memoize 装饰的普通函数才支持 delete_memoized。
- 清除某个视图缓存:
cache.delete('view/' + request.path)(需知道默认 key 格式) - 更稳妥:给视图加
key_prefix='user_profile',然后用cache.delete('user_profile') -
cache.clear()会清空整个后端存储,生产环境慎用,尤其多服务共用一个 Redis 时 - 数据库写操作后立即清除缓存,别等到下一次请求才触发——否则有短暂不一致窗口
本地开发用 SimpleCache,上线切 Redis:配置差异直接影响行为
SimpleCache 是内存缓存,进程一重启全丢,适合本地调试;但上线必须换 Redis 或 Memcached,否则多进程/多实例下缓存不共享,还会因内存暴涨拖垮服务。
容易踩的坑是配置写错导致降级成 NullCache(完全不缓存),比如 Redis 连接失败时默认静默失败,日志里也不报错,结果你反复刷页面发现根本没生效。
- 开发配置:
config['CACHE_TYPE'] = 'SimpleCache',不用配地址 - 生产配置:
config['CACHE_TYPE'] = 'RedisCache',并设config['CACHE_REDIS_URL'] = 'redis://localhost:6379/1' - 务必检查
cache._cache实例类型:启动后打印type(cache._cache),确认不是NullCache - Redis 缓存大对象(比如上 MB 的 JSON)时,注意
maxmemory设置和淘汰策略,否则可能 silently miss
缓存逻辑越靠近业务层,越容易漏掉清除时机;视图函数里嵌套调用的数据库查询,如果单独缓存了,就得额外维护那部分的失效逻辑——这点常常被忽略。










