Article
2026-02-28-HR主数据_接口融合
蚂蚁集团-人事板块
接口融合（接口搬迁 2.0）
一、背景
在接口搬迁完成后，新系统已承载原老系统的一千多个接口。
但从领域建模角度看：
- 实际业务复杂度并不需要上千个接口；
- 在主数据领域内（员工、部门、汇报线、职务体系等）， 通过约两百多个领域级接口即可覆盖核心能力。
因此，需要进行一次接口融合：
- 对冗余接口进行收敛
- 引导上游系统逐步迁移至新的领域接口
- 为后续长期演进建立清晰的领域边界
二、核心目标
- 将原 1000+ 接口收敛为约 200+ 领域级接口
- 保持老接口对外可用，实现无感知切换
- 新接入系统直接调用领域接口
- 老接口逐步退出历史舞台
三、整体思路
1️⃣ 领域重新划分
基于主数据领域进行重构划分：
- 员工域
- 部门域
- 汇报线域
- 职务体系域
- 跨领域聚合接口
将原有接口进行分类：
- 可直接被领域接口替代的
- 需要参数适配的
- 需要跨领域整合的
接口融合的本质是领域收敛，而不是简单减少接口数量。
2️⃣ 老接口壳层化
融合阶段采用兼容策略：
老接口流程调整为：
老接口
→ 参数转换
→ 新领域接口
→ 执行逻辑
→ 结果转换
→ 返回老接口格式
老接口仅保留：
- 参数适配
- 结果适配
- 协议兼容
核心逻辑全部集中在新的领域接口中。
3️⃣ 低流量接口下线策略
对于老接口：
- 若调用量极低或为零流量
- 分析历史调用记录
- 确认调用系统及负责人
- 与相关同学确认是否仍在使用
确认无实际使用后，直接下线。
通过这种方式，逐步减少历史包袱，而不是无限期保留兼容壳层。
四、复杂链路情况
在极端场景下可能出现：
外部系统
→ 老系统老接口
→ 转发到新系统老接口
→ 协议层
→ 新领域接口
可能经过多层转发与网关。
因此在稳定性模型上，与接口搬迁阶段高度相似。
五、稳定性与灰度策略
接口融合复用了接口搬迁阶段的能力：
- 可观测体系
- 链路追踪
- 流量分析
- 灰度组件
不同点在于：
- 接口搬迁解决的是“系统切换”
- 接口融合解决的是“接口收敛”
但灰度推动与业务沟通方式基本一致。
六、难点说明
接口融合的难点主要在：
- 领域边界划分
- 与上游系统的沟通协调
整体难度与接口搬迁相近， 更多体现在业务理解与协作成本上， 而非底层技术复杂度。
七、总结
接口融合是在接口搬迁基础上的一次能力收敛：
- 从 1000+ 接口收敛到 200+ 领域级接口
- 老接口壳层化
- 低流量接口逐步下线
- 通过灰度与沟通推动演进
它是对系统结构的整理与优化， 为后续长期演进奠定基础。