4. 配置缓存机制：缓存策略(TTL/LRU)、缓存键设计、缓存命中与未命中场景、缓存一致性

在云原生平台门户中，RBAC 配置（如 Role、ClusterRole、RoleBinding、ClusterRoleBinding）被频繁读取。若每次巡检都直接请求 Kubernetes API Server，不仅会增加 API Server 负载，还会因网络延迟导致巡检响应变慢。因此，引入本地缓存机制是提升巡检性能的关键手段。本章将详细阐述缓存策略、键设计、命中/未命中场景以及一致性保障方案。

4.1 缓存策略：TTL 与 LRU

缓存策略决定了数据在缓存中的存储时长与淘汰方式。针对 RBAC 配置的巡检场景，推荐采用 TTL（Time-To-Live） 与 LRU（Least Recently Used） 组合策略。

4.2 缓存键设计

缓存键（Cache Key）必须能够唯一标识一次 RBAC 配置查询。设计不当会导致缓存冲突或命中率下降。以下是推荐的缓存键结构：

cache_key = "rbac:inspect:{cluster_id}:{namespace}:{resource_type}:{resource_name}:{verb}"

各字段说明：

• cluster_id：集群唯一标识，用于多集群场景。
• namespace：命名空间，对于 ClusterRole/ClusterRoleBinding 使用空字符串或 "_cluster"。
• resource_type：资源类型，如 Role、RoleBinding、ClusterRole、ClusterRoleBinding。
• resource_name：资源名称。
• verb：操作动词，如 get、list、watch。

4.3 缓存命中与未命中场景

理解缓存命中与未命中的处理流程，是设计巡检逻辑的基础。下图展示了完整的缓存查询路径：

缓存命中与未命中的对比：

4.4 缓存一致性

缓存一致性是分布式缓存中最具挑战的问题。在 RBAC 配置巡检场景中，一致性要求可以适当放宽（最终一致性），但必须避免长时间的数据不一致。

4.4.1 一致性挑战

• 数据更新延迟：RBAC 配置被修改后，缓存中的旧数据可能被继续使用。
• 并发写入：多个巡检实例同时更新缓存，可能导致数据覆盖或丢失。
• 集群间同步：多集群场景下，一个集群的 RBAC 变更需要通知其他集群的缓存。

4.4.2 一致性保障策略

4.4.3 主动失效实现示例

以下代码展示了如何通过监听 Kubernetes 事件实现缓存主动失效：

// 伪代码：监听 RBAC 变更事件并失效缓存
func WatchRBACAndInvalidateCache(ctx context.Context, cache *Cache) {
    watcher, err := clientset.RbacV1().Roles("").Watch(ctx, metav1.ListOptions{})
    if err != nil {
        log.Fatalf("Failed to watch RBAC: %v", err)
    }

    for event := range watcher.ResultChan() {
        switch event.Type {
        case watch.Added, watch.Modified, watch.Deleted:
            role, ok := event.Object.(*rbacv1.Role)
            if !ok {
                continue
            }
            // 构造缓存键并删除
            key := fmt.Sprintf("rbac:inspect:%s:%s:Role:%s:get",
                clusterID, role.Namespace, role.Name)
            cache.Delete(key)
            log.Printf("Cache invalidated for key: %s", key)
        }
    }
}

4.5 缓存一致性模型总结

根据云原生平台门户的巡检需求，推荐采用 最终一致性 模型，并辅以以下措施：

• TTL 设置 60s：确保缓存数据最多落后集群状态 60 秒。
• Watch 主动失效：当 RBAC 配置发生变更时，立即删除对应缓存条目。
• LRU 淘汰：当缓存条目超过上限时，淘汰最久未使用的条目，避免内存溢出。
• 缓存穿透保护：对于不存在的资源（如查询一个不存在的 Role），缓存空结果并设置短 TTL（如 10s），防止恶意请求穿透到 API Server。