适用对象与实施前提
多区域部署、同一标识存在多个可服务节点、调用方授权范围不一致的平台环境,适合按这一指南推进。单一节点、单一调用方的简单场景,按接入流程登记节点与策略即可,不需要完整的组合设计。
实施前需要三项准备:业务与调用方清单、节点与区域清单、权限边界说明。三项不齐时,候选集无法稳定,策略只能在猜测中配置,联调阶段也会反复退回。
路径选择只决定请求经过哪些节点,业务正文由接入方的服务节点处理。实施目标是把选择过程写成可核对的规则,不改变业务系统的处理方式,也不评价业务结果。
从业务清单到节点清单
先按业务域列出需要寻址的标识,再为每个标识列出可服务节点。标识是请求目标的唯一标识,候选范围不超出该标识登记的服务节点;跨出登记范围的选择无法核对。
清单不需要写得冗长,但每一项都要能落到具体字段。用途、能力、区域、权限四类信息缺失时,节点登记会留下空白,路径选择只能依赖默认值,排查时难以判断原因。
| 清单项 | 要确认的内容 | 落到哪里 |
|---|---|---|
| 标识 | 用途、归属主体、调用方范围 | 标识登记 |
| 能力 | 请求需要的服务能力与请求类型 | 节点能力说明 |
| 区域 | 节点所在区域与就近关系 | 节点区域字段 |
| 节点 | 入口、调度、服务、记录的分工 | 节点登记 |
| 权限 | 哪些调用方可以访问哪些节点 | 授权范围与策略条件 |
候选集怎么划
候选集由标识、能力、权限与节点状态共同决定。先按标识取候选节点,再按权限删去范围外节点,然后用状态排除维护与不可用节点,最后进入排序。顺序固定,过滤结果才能写入记录并复核。
候选集过大时排序结果不稳定,过小时容易返回无可用路径。按区域分层、按能力拆分,比把所有节点放进同一候选集更容易核对;拆分后每个标识的候选范围也更清楚。
- 同一标识的候选节点写明区域,避免跨区域选择时缺少依据。
- 授权范围按调用方分别登记,不用一份宽范围授权覆盖多个用途。
- 维护与不可用节点及时更新状态,避免进入候选集后又被排除。
- 受限节点只接收授权范围内的请求,登记时写明限制条件。
- 节点端点变化后按变更流程提交,候选按新记录重新生成。
策略组合的取舍
四类策略可以组合,但组合要有主次。权限是前置条件,其余策略影响排序与切换;条件越多,候选集越小,需要同时确认备选路径仍然可用。条件叠加后没有可用节点,通常说明登记缺少节点,与策略条件本身无关。
组合前先写出业务目标:是就近、是版本切换、还是主路径波动时的兜底。目标写清后再选策略,可以减少为了覆盖所有情况而堆叠条件。
| 业务情形 | 建议组合 | 需要确认 |
|---|---|---|
| 多区域就近服务 | 权限优先加就近优先 | 同区域节点不足时是否有备选 |
| 标识记录刚变更 | 权限优先加版本优先 | 旧版本是否立即失效 |
| 主路径易波动 | 可达优先加就近优先 | 备选节点是否与主节点同故障域 |
| 授权范围受限 | 权限优先 | 超出范围时是否直接拒绝 |
备选路径与切换设计
切换只影响本次请求,不修改节点登记信息。备选路径需要单独验证,不能默认主路径可用就等于备选可用;主路径恢复后,新请求按策略重新选择,处理中的请求不自动切回。
备选路径也要满足权限条件。备选节点距离更近、状态更好,但不在授权范围内时,同样不能进入候选集,系统会返回无可用路径。
- 为主路径列出至少一条备选路径,写明节点、区域与优先级。
- 确认备选节点与主节点不在同一故障域,避免同时不可用。
- 在策略中写明切换条件:维护、不可用、约定时间内无结果、可识别的服务失败。
- 用测试请求触发一次切换,核对切换记录中的原节点、备选节点、原因与时间。
- 主路径恢复后观察新请求的选择结果,确认不自动切回处理中的请求。
联调核对清单
联调覆盖同区域与跨区域、授权内与授权外、主路径可用与不可用几种情况。每类请求保留请求编号,便于与路由记录、切换记录逐条对照;只核对成功请求,会漏掉权限过滤与失败返回的问题。
核对时把最终节点、选择原因与策略版本放在一起看。最终节点符合预期但原因不对,说明策略条件与预期不一致,后续变更仍可能出错。
- 同区域请求是否选中同区域节点,跨区域请求是否有明确依据。
- 授权外的调用是否返回拒绝,不进入未授权节点。
- 主路径不可用时是否按策略切换,备选也不可用时是否返回明确失败。
- 返回结果是否包含主路径、备选路径、记录版本与状态。
- 记录是否包含调用方、目标、候选节点、最终节点、选择原因与时间。
- 切换记录是否包含原节点、备选节点、原因与时间。
上线后的复核节奏
上线后按变更事件复核:节点端点、能力、区域或策略变化后,抽查同类请求的选择结果,确认候选集与排序没有意外变化。复核以记录为依据,按请求编号或时间范围查询。
发现偏差时先看节点状态,再看策略版本,一次只调整一个条件。多个条件同时调整,记录难以对应到具体原因,复核也会失去参照。
策略变更需要保留上一版本与回退方式;回退后同样抽查记录,确认回到预期版本。回退针对异常处理,恢复针对主路径重新可用,两者在记录中的含义不同。
- 候选集为空时如何处理
- 返回无可用路径,不降级到未授权节点。先补登记或调整策略,再用测试请求重新验证。
- 节点恢复后需要手动切回吗
- 不需要。新请求按策略重新选择,处理中的请求不自动切回。