4. 服务目录平台架构：核心功能与分层设计
服务目录平台是黄金路径声明式管理的核心枢纽，承担着服务注册、动态发现与治理决策的职责。在冷启动削峰场景下，平台架构必须支持高并发写入、低延迟查询以及声明式策略的实时下发。本节从核心功能与分层架构两个维度展开。
4.1 核心功能：注册、发现、治理
服务目录围绕三个核心能力构建，三者形成闭环：
| 功能 | 职责 | 冷启动削峰关键要求 |
|---|---|---|
| 服务注册 | 服务实例上线时，将元数据（IP、端口、版本、健康状态、标签）写入目录。 | 支持批量注册与异步写入，避免注册风暴导致数据层写入瓶颈。 |
| 服务发现 | 消费者从目录获取目标服务的可用实例列表，支持轮询、一致性哈希等路由策略。 | 提供本地缓存 + 长轮询/Watch 机制，削峰期间减少对数据层的直接查询。 |
| 服务治理 | 基于声明式策略（流量权重、熔断、限流、灰度标签）动态调整服务路由与访问规则。 | 策略变更通过声明式 API 下发，数据层仅存储最终状态，计算逻辑上浮至服务层。 |
设计原则： 注册与发现面向数据一致性，治理面向策略执行。在冷启动削峰期间，治理策略应优先使用本地缓存副本，避免每次请求都穿透到数据层。
4.2 平台分层架构
服务目录平台采用经典的三层架构：接入层、服务层、数据层。每层职责清晰，通过声明式 API 契约解耦。
4.2.1 分层职责与组件
| 层级 | 核心组件 | 主要职责 | 削峰关注点 |
|---|---|---|---|
| 接入层 | API Gateway、负载均衡器、TLS 终止 | 协议转换、认证鉴权、流量整形、限流熔断 | 削峰期间前置限流，拒绝超载请求，保护下游服务层 |
| 服务层 | 注册服务、发现服务、治理引擎、缓存模块 | 业务逻辑编排、声明式策略解析、本地缓存维护、事件推送 | 无状态水平扩展，缓存命中率 > 99%，异步写数据层 |
| 数据层 | 分布式 KV 存储（etcd / ZooKeeper / Consul）、持久化数据库 | 最终状态存储、数据一致性保证、Watch 机制 | 写入 QPS 控制在集群能力 60% 以下，避免 Leader 频繁选举 |
4.2.2 分层架构图
下图展示了服务目录平台的三层架构及核心交互流程：
4.3 声明式 API 在分层中的流转
声明式管理要求用户只描述期望状态，平台负责调和。在分层架构中，声明式 API 的流转路径如下：
- 用户提交声明式 YAML（例如：期望服务 A 有 10 个实例，权重 80%）。
- 接入层 校验语法与权限，将请求转发至服务层。
- 服务层治理引擎 解析声明，计算当前状态与期望状态的差异，生成调和指令。
- 服务层 将最终状态写入数据层，同时更新本地缓存。
- 数据层 通过 Watch 机制通知所有订阅节点，完成状态收敛。
冷启动削峰优化： 在服务层引入写缓存队列，将高频注册/更新请求批量合并后异步写入数据层，避免数据层瞬时写入压力超过集群承载能力。缓存队列长度与数据层写入 QPS 阈值需通过压测确定。
4.4 分层架构的削峰能力对比
| 削峰策略 | 所属层级 | 实现方式 | 削峰效果 |
|---|---|---|---|
| 前置限流 | 接入层 | 基于令牌桶或漏桶算法，拒绝超载请求 | 直接丢弃过量请求，保护下游 |
| 本地缓存 | 服务层 | 服务发现结果本地缓存 + 长轮询增量更新 | 减少 90% 以上数据层查询 |
| 异步批量写 | 服务层 → 数据层 | 写请求先入内存队列，合并后批量写入 | 数据层写入 QPS 降低 60%-80% |
| Watch 推送 | 数据层 | 数据变更通过 Watch 机制主动推送，避免客户端轮询 | 减少无效查询，降低数据层读压力 |
4.5 架构设计要点总结
- 接入层无状态：便于水平扩展，削峰期间可快速扩容。
- 服务层缓存优先：声明式调和结果优先从本地缓存读取，缓存未命中时再查询数据层。
- 数据层选型：优先选择支持 Watch 机制与强一致性的分布式 KV 存储（如 etcd），避免使用关系型数据库作为服务注册中心。
- 声明式 API 版本化：服务层治理引擎需兼容多版本声明式 API，支持灰度升级。
避坑提示： 不要将服务层与数据层直接耦合。服务层应通过声明式 API 契约与数据层交互，避免在服务层中直接操作数据层内部数据结构（如 etcd 的目录结构）。否则，数据层升级或迁移将导致服务层大规模改造。