Flask缓存怎么用_Flask-Caching扩展缓存视图函数返回结果

用 @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

缓存逻辑越靠近业务层，越容易漏掉清除时机；视图函数里嵌套调用的数据库查询，如果单独缓存了，就得额外维护那部分的失效逻辑——这点常常被忽略。