2. 服务目录概述：定义、作用与缓存关系
服务目录（Service Catalog）是微服务架构中所有可发现、可调用、可治理的服务元数据集合。它不仅是服务注册与发现的“电话簿”，更是缓存水位治理的元数据锚点——没有精确的服务目录，缓存水位复核就失去了基准线。
2.1 服务目录的定义
服务目录以结构化元数据描述每个微服务的身份、接口、依赖、部署特征与运行时契约。一个标准服务目录条目通常包含以下核心字段：
| 元数据类别 | 字段示例 | 说明 |
|---|---|---|
| 身份标识 | service_id, service_name, version | 全局唯一服务标识，用于缓存键命名空间隔离 |
| 网络端点 | host, port, protocol, health_check_uri | 决定缓存客户端连接池与超时配置 |
| 接口契约 | api_paths, request/response schema, rate_limit | 影响缓存键设计、TTL 策略与降级逻辑 |
| 依赖关系 | upstream_services, downstream_services | 级联缓存失效范围与一致性边界 |
| 部署属性 | cluster, namespace, replicas, resource_quota | 缓存容量规划与水位阈值的输入参数 |
| 运行时状态 | status, last_heartbeat, load_score | 实时水位复核的决策依据 |
SRE 视角： 服务目录不是静态文档，而是与配置中心、注册中心、CMDB 实时同步的活性元数据。缓存水位复核依赖的“服务维度”必须从目录中动态拉取，而非硬编码。
2.2 服务目录在微服务架构中的作用
服务目录在微服务体系中承担三大核心职能，直接关联缓存架构的稳定性：
- 服务发现与路由 —— 客户端通过目录获取目标服务实例列表，缓存客户端据此建立连接池；目录变更（扩缩容、故障转移）触发缓存连接重建。
- 治理策略下发 —— 目录中携带的限流、熔断、超时配置，决定缓存穿透时的回源保护策略；水位复核时需校验目录策略与缓存行为是否一致。
- 依赖拓扑可视化 —— 目录记录的上下游依赖关系，是缓存级联失效分析的基础；单服务缓存水位异常可能通过依赖链扩散。
2.3 服务目录与缓存的关系
服务目录与缓存之间存在三层紧密耦合关系，直接决定缓存水位复核的准确性与可操作性：
| 关系维度 | 服务目录提供 | 缓存侧依赖 | 水位复核影响 |
|---|---|---|---|
| 命名空间 | service_id + version | 缓存键前缀、集群分组 | 水位按服务粒度聚合，避免跨服务干扰 |
| 容量规划 | replicas, resource_quota, 预估 QPS | 缓存内存上限、连接池大小 | 水位阈值与目录中服务规格对齐 |
| 一致性边界 | upstream/downstream 依赖链 | 缓存失效策略、TTL 设计 | 级联失效范围由目录拓扑决定 |
关键原则： 缓存水位复核必须以服务目录为“服务维度”的唯一数据源。任何脱离目录的缓存水位分析，都会因元数据不一致导致误判——例如将 A 服务的缓存膨胀误归因于 B 服务。
2.4 服务目录驱动缓存水位复核的流程
在实际 SRE 运维中，服务目录与缓存水位复核的交互遵循以下标准化流程：
- 目录同步 —— 从注册中心/配置中心拉取全量服务元数据，构建内存中的服务目录快照。
- 缓存映射 —— 将每个服务映射到对应的缓存集群、键空间、TTL 策略。
- 水位采集 —— 按服务维度聚合缓存指标（内存使用率、键数量、命中率、驱逐率）。
- 阈值比对 —— 将采集水位与服务目录中定义的容量规格、SLO 阈值进行比对。
- 异常定位 —— 当水位超过阈值时，通过目录中的依赖拓扑追溯根因服务。
- 策略调整 —— 根据复核结果调整缓存配置或触发服务降级。
常见陷阱： 服务目录与缓存集群之间的映射关系如果手动维护，极易出现“目录中已下线服务仍在缓存中占用内存”的情况。必须通过自动化同步机制保证目录变更实时反映到缓存水位复核范围中。
2.5 服务目录元数据对缓存水位的关键影响
以下三类目录元数据直接决定缓存水位复核的精度：
- 服务版本 (version) —— 版本升级可能导致缓存键结构变化，旧版本缓存成为“僵尸数据”，抬高水位而不产生价值。
- 实例数 (replicas) —— 扩缩容时缓存连接数、内存分配需同步调整；目录中 replicas 与实际不符会导致水位阈值偏差。
- 依赖拓扑 (dependencies) —— 上游服务缓存失效会引发下游缓存回源风暴，水位复核必须考虑依赖链上的级联效应。