dify通过l1本地缓存(sync.map,需启用dify_cache_local_enabled=true)、l2 redis缓存(推荐环境变量配置,default_ttl≤600秒)和l3语义缓存(需后台启用嵌入模型并勾选开关)三级协同,在200ms内达成低延迟问答全链路响应;布隆过滤器强制拦截非法key防穿透。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在低延迟问答场景中,Dify需在200ms内完成用户提问→上下文检索→LLM推理→结果返回的全链路响应,多级缓存策略直接决定能否达成该硬性指标。
本地缓存(L1):拦截高频重复查询
启动Dify服务时,进程内自动初始化sync.Map作为本地缓存,用于存储最近10分钟内被命中超过5次的提示词模板与会话元数据。
这一步无需手动配置,但必须确保环境变量DIFY_CACHE_LOCAL_ENABLED=true已启用,否则L1层将完全失效。
本地缓存不跨进程共享,因此在K8s多副本部署下,每个Pod需独立积累热度——这意味着冷启动后前30秒的缓存命中率天然偏低。
Redis缓存(L2):保障跨实例状态一致
方法一:通过Dify配置文件显式启用
编辑dify.yaml,在cache节点下设置:
type: redisredis_url: redis://10.20.30.40:6379/1default_ttl: 600
【default_ttl必须设为600秒而非更大值】——问答类数据时效性敏感,超过10分钟的缓存会导致用户反复提问相同问题时得到过期上下文。
方法二:使用环境变量动态覆盖(推荐用于灰度发布)
在容器启动命令中注入:-e DIFY_CACHE_REDIS_URL=redis://redis-prod:6379/2 -e DIFY_CACHE_DEFAULT_TTL=300
该方式无需重启服务即可生效,但仅对新创建的缓存键生效,已有键仍按原TTL过期。
语义缓存(L3):匹配相似问题避免重复推理
第一步:确认嵌入模型已启用
进入Dify管理后台 → 设置 → 模型配置 → 嵌入模型,选择text-embedding-ada-002或兼容的开源模型。
第二步:开启语义缓存开关
在工作流节点配置中勾选“启用语义缓存”,此时系统会对输入问题生成向量,并在Redis中检索余弦相似度>0.85的历史问答对。
第三步:调整相似度阈值
若发现误命中(如“苹果手机怎么重启”匹配到“苹果公司财报发布时间”),需登录Redis CLI执行:CONFIG SET dify:semantic:similarity_threshold 0.92。该操作立即生效,无需重启。
注意:语义缓存仅对开启该功能的工作流节点生效,未勾选的节点不会触发向量化计算。
缓存穿透防护:布隆过滤器预检非法Key
在Redis连接池初始化阶段,Dify自动加载布隆过滤器并预置10万条常见无效问法哈希(如“/admin”, “../../../etc/passwd”, 空格+特殊符号组合)。
当请求携带的query经布隆过滤器判定为“可能不存在”时,直接返回HTTP 400并记录审计日志,跳过所有缓存层级与数据库查询。
这一步无法关闭,但可通过修改config/bloom_filter.yaml中的expected_insertions参数扩容过滤器容量——扩容后需重启服务才生效。











