3. 缓存机制基础：Kustomize 内置缓存层级、LRU 缓存策略、缓存键的生成规则

Kustomize 的缓存机制是提升大规模配置渲染性能的核心。理解其内置缓存层级、淘汰策略以及键的生成规则，是诊断缓存命中瓶颈、进行架构优化的前提。本章将深入剖析这三层基础架构。

3.1 内置缓存层级架构

Kustomize 采用 两级缓存架构：本地文件系统缓存（L1） 和 进程内内存缓存（L2）。L1 用于持久化远程资源（如 Git 仓库、HTTP URL）的拉取结果，L2 用于加速同一进程内对相同资源的重复解析。

3.2 LRU 缓存淘汰策略

L1 文件系统缓存使用 LRU（Least Recently Used） 策略进行淘汰，以防止缓存目录无限膨胀。Kustomize 会记录每个缓存条目的最后访问时间，当缓存总大小超过阈值时，优先淘汰最久未被访问的条目。

LRU 淘汰的具体流程如下：

1. 访问记录： 每次从缓存读取资源时，更新该条目的 atime（访问时间）元数据。
2. 阈值检查： 后台协程定期扫描缓存目录，计算总大小。
3. 候选排序： 若总大小超过阈值，按 atime 升序排列所有条目。
4. 批量淘汰： 从最旧的条目开始删除，直到总大小降至阈值的 80%（软限制）。

3.3 缓存键的生成规则

缓存键（Cache Key）是决定缓存命中率的核心因素。Kustomize 为不同类型的资源使用不同的键生成规则，确保唯一性同时避免过度差异化导致缓存失效。

3.3.1 远程 Git 仓库缓存键

对于 git:: 或 github.com/ 形式的远程 base，缓存键由以下字段拼接而成：

缓存键 = {仓库URL} + {分支/标签} + {提交哈希} + {子路径}

3.3.2 HTTP/HTTPS 资源缓存键

对于 https:// 形式的远程文件，缓存键基于 URL 标准化 和 响应头 生成：

缓存键 = SHA256(标准化URL) + ETag/Last-Modified

• 标准化URL： 去除查询参数中的随机值（如 ?t=timestamp），排序所有参数。
• ETag/Last-Modified： 优先使用 ETag 响应头；若不存在，则使用 Last-Modified；两者都无则使用 Content-Length + 下载时间戳。

3.3.3 本地文件系统缓存键

对于本地 file:// 路径或相对路径引用的 base，缓存键基于 文件内容的哈希：

缓存键 = SHA256(文件内容) + 文件路径

这种方式确保即使文件名不变，内容变化也会导致缓存失效，避免脏缓存问题。

3.4 缓存键冲突与性能影响

缓存键的设计直接影响命中率。以下表格总结了不同场景下的缓存行为：

3.5 缓存失效与一致性保证

Kustomize 通过以下机制保证缓存数据与源数据的一致性：

• Git 缓存： 每次访问时，如果缓存键中包含分支名（而非提交哈希），Kustomize 会执行 git fetch origin <branch> 检查远程是否有新提交。若有，则更新缓存键中的提交哈希并重新拉取。
• HTTP 缓存： 遵循 HTTP 标准缓存控制头（Cache-Control、Expires），并在条件请求中使用 If-None-Match（ETag）或 If-Modified-Since（Last-Modified）验证缓存有效性。
• 文件缓存： 依赖文件系统的 mtime（修改时间）和 inode 变化检测。若文件被修改，则重新计算内容哈希并更新缓存。