1. 课程导论：为什么需要服务边界划分与接口版本迁移策略？
1.1 从单体到微服务：边界模糊引发的连锁故障
在传统单体架构中，所有业务逻辑运行在同一个进程内，接口调用本质上是内存级的方法调用。当系统演进为分布式微服务架构后，服务之间的通信从本地调用变为网络调用，服务边界成为决定系统稳定性、可维护性和发布效率的核心因素。
一个典型的反面案例：某电商平台在促销活动前，订单服务与库存服务共享同一个数据库表结构。当库存团队为了优化缓存而修改了库存查询接口的返回字段格式后，订单服务未及时更新，导致大促期间订单创建失败，造成数十分钟的线上故障。根本原因在于：服务边界未清晰划分，接口契约缺乏版本管理。
核心观点：服务边界划分决定了接口的变更范围；接口版本迁移策略决定了变更能否平滑落地。两者共同构成了后端发布拓扑的“安全护栏”。
1.2 服务边界划分的核心价值
服务边界划分不是简单的代码拆分，而是对业务领域、数据所有权、通信契约的系统性设计。其价值体现在三个维度：
| 维度 | 未划分边界 | 清晰划分边界 |
|---|---|---|
| 变更影响 | 一个接口变更可能波及 5-10 个下游服务 | 变更影响范围控制在 1-2 个服务内 |
| 发布频率 | 团队间强依赖，每周只能发布 1-2 次 | 独立发布，每日可发布 10+ 次 |
| 故障隔离 | 单个接口变更可能导致级联雪崩 | 故障被边界隔离，不会跨服务扩散 |
| 团队自治 | 需要跨团队评审所有接口变更 | 团队可自主决策内部接口演进 |
从发布拓扑的角度看，服务边界就是发布单元的物理边界。每个服务应当拥有独立的部署流水线、数据库实例和运行时进程。当边界清晰时，接口版本迁移只需要在边界两侧的服务之间协调；当边界模糊时，一次接口变更可能需要协调 5 个以上的服务同时发布。
1.3 接口版本迁移：为什么不能“原地修改”？
在分布式系统中，接口的消费者和提供者通常运行在不同的发布节奏上。如果提供者直接修改接口（原地修改），会导致以下问题：
- 消费者未同步更新：消费者仍使用旧接口格式，请求失败或数据解析错误。
- 灰度发布困难：无法让部分流量走新接口、部分流量走旧接口。
- 回滚风险：如果新接口有问题，回滚提供者后，消费者可能已经依赖新接口。
- 多版本共存：不同消费者可能处于不同的升级阶段，需要同时支持多个接口版本。
接口版本迁移策略的核心目标就是：在不中断服务的前提下，让接口的提供者和消费者能够独立演进。常见的迁移策略包括：
| 策略 | 原理 | 适用场景 | 复杂度 |
|---|---|---|---|
| URL 路径版本 | /v1/orders → /v2/orders |
外部 API、长期维护 | 低 |
| 请求头版本 | Accept: application/vnd.company.v2+json |
RESTful 风格、内容协商 | 中 |
| 查询参数版本 | /orders?version=2 |
快速迭代、内部服务 | 低 |
| 兼容扩展 | 新增字段，不删除/修改旧字段 | 内部服务、强契约 | 低 |
| 并行部署 | 新旧服务同时运行，逐步切换流量 | 重大重构、数据迁移 | 高 |
实践建议：对于内部微服务之间的 RPC 调用（如 gRPC、Thrift），优先使用兼容扩展策略（新增字段 + 默认值），避免频繁创建新版本。对于外部 API，推荐使用 URL 路径版本，因为其语义清晰、易于缓存和路由。
1.4 发布拓扑中的版本迁移挑战
当我们将服务边界划分和接口版本迁移放在发布拓扑的上下文中时，会面临更复杂的挑战。发布拓扑描述了服务之间的依赖关系、部署单元和流量路径。一个典型的发布拓扑包含以下元素：
- 服务节点：每个服务是一个独立的部署单元。
- 依赖边：服务之间的调用关系（同步/异步）。
- 网关/入口：外部流量进入系统的统一入口。
- 数据存储：每个服务可能拥有独立的数据库。
- 消息队列：异步通信的中间件。
在发布拓扑中进行接口版本迁移时，需要回答以下关键问题：
- 迁移顺序：先升级提供者还是先升级消费者？
- 兼容窗口：新旧版本需要共存多长时间？
- 流量切换：如何逐步将流量从旧版本切换到新版本？
- 回滚策略：如果新版本出现问题，如何快速回滚？
- 监控验证：如何确认迁移过程中没有引入错误？
1.5 本课程的学习路径
本课程将围绕“服务边界划分”和“接口版本迁移”两个核心主题，系统性地讲解后端发布拓扑中的最佳实践。课程分为以下模块：
| 模块 | 内容 | 实践产出 |
|---|---|---|
| 模块 1：服务边界设计 | DDD 限界上下文、数据所有权、服务粒度评估 | 服务边界划分文档模板 |
| 模块 2：接口契约管理 | OpenAPI / gRPC Proto 版本策略、兼容性检查 | 接口版本管理规范 |
| 模块 3：发布拓扑建模 | 依赖图分析、发布顺序编排、灰度策略 | 发布拓扑可视化工具 |
| 模块 4：迁移实战 | 并行部署、流量镜像、蓝绿发布、回滚演练 | 迁移剧本与检查清单 |
| 模块 5：治理与自动化 | API 网关路由、服务网格、CI/CD 集成 | 自动化迁移流水线 |
前置要求：本课程假设你已经具备微服务架构的基本知识，了解 RESTful API 或 gRPC 的基本概念，并有一定的后端开发经验。如果你对服务网格（Service Mesh）或 DDD 领域驱动设计还不熟悉，建议先补充相关基础知识。
通过本课程的学习，你将能够：
- 识别服务边界划分中的常见陷阱，并应用 DDD 限界上下文进行合理拆分。
- 设计接口版本迁移策略，确保在发布拓扑中平滑演进。
- 构建可观测的发布流程，在灰度切换和回滚时保持系统稳定。
- 将版本迁移策略自动化集成到 CI/CD 流水线中，减少人工操作风险。