20260514:增加新内容

concepts/cache-invalidation.md

@@ -0,0 +1,32 @@
+---
+title: "Cache Invalidation（缓存失效）"
+created: 2026-05-11
+updated: 2026-05-11
+type: concept
+tags: [cache, system-design, debugging]
+sources: [[prompt-caching-architecture]]
+---
+
+# Cache Invalidation（缓存失效）
+
+## 定义
+
+Cache Invalidation 指 [[prompt-caching|Prompt Caching]] 中缓存前缀因字节级不匹配而导致整个缓存树失效的现象。由于 [[prefix-matching|前缀匹配]] 的高严格性，任何对前缀的微小更改都会触发"雪崩式"失效。
+
+## 常见触发源
+
+1. **System Prompt 动态变量**：日期、状态摘要、不确定的路径名
+2. **工具定义动态调整**：按需加载/移除工具（→ 使用 [[stub-pattern|Stub 模式]] 规避）
+3. **System Message 滥用**：频繁更新 System Message 切换状态（→ 使用消息化状态管理）
+4. **压缩操作不当**：独立 API 调用使用不同的 System Prompt
+
+## 失效点识别
+
+系统应记录导致失效的"第一现场"——通过日志追踪失效点的字节偏移，快速定位代码逻辑缺陷。
+
+## 相关概念
+
+- [[prefix-matching|前缀匹配]]
+- [[prompt-caching|Prompt Caching]]
+- [[cache-hit-ratio|缓存命中率]]
+- [[system-message-abuse|System Message 滥用]]