1. 课程导论：服务边界与搜索索引映射的关系、版本管理在分布式搜索中的核心挑战

1.1 服务边界：为什么搜索索引需要“映射”而非“复制”

在单体架构中，搜索索引通常与业务数据库共享同一事务边界：数据写入后立即同步更新索引，一致性由本地事务保证。然而，当系统演进为微服务或分布式架构后，每个服务拥有独立的数据库、独立的部署周期和独立的团队。此时，搜索索引不再能直接读取业务数据库，而必须通过服务边界获取数据。

服务边界带来的核心变化是：索引数据不再是业务数据的本地副本，而是跨服务的事件流投影。这种投影关系被称为“搜索索引映射”（Search Index Mapping）。映射的质量直接决定了搜索结果的准确性与时效性。

下表对比了单体索引与分布式映射索引的核心差异：

1.2 搜索索引映射的典型结构

一个典型的分布式搜索索引映射包含三个层次：源服务层、映射转换层和索引存储层。源服务通过事件总线（如 Kafka）发布数据变更事件；映射转换层消费事件，执行字段映射、数据合并和反范式化；最终写入搜索引擎（如 Elasticsearch）的索引文档。

1.3 版本管理在分布式搜索中的核心挑战

当索引映射跨越服务边界时，版本管理不再是简单的“索引重建”问题，而是演变为一个涉及数据一致性、服务兼容性和部署协调的复合挑战。以下是四个核心挑战：

1. 字段版本漂移：源服务修改了某个字段的含义或类型，但映射层未及时更新，导致索引文档中的字段值与业务语义不一致。
2. 事件顺序乱序：分布式环境下，事件到达映射层的顺序可能与产生顺序不同，导致旧事件覆盖新事件（旧数据覆盖新数据）。
3. 映射版本与服务版本耦合：索引映射的版本必须与消费的源服务版本对齐，否则可能读取到不兼容的事件结构。
4. 滚动升级与回滚：当索引映射需要变更时，如何在不中断搜索服务的情况下完成升级？如何安全回滚？

1.4 版本管理的关键维度

为了系统化地解决上述挑战，我们需要从三个维度管理索引映射的版本：

这三个维度相互独立又彼此影响。例如，当映射版本升级时，可能需要同时提升索引版本以支持新的字段结构；而数据版本则用于在事件乱序时判断哪条数据是最新的。

1.5 版本兼容设计的核心目标

本课程将围绕以下四个目标展开：

• 向前兼容：旧版本的索引映射仍能正确处理新版本的事件。
• 向后兼容：新版本的索引映射能正确处理旧版本的事件。
• 零停机升级：索引映射变更期间，搜索服务不中断。
• 可回滚：当升级出现问题时，能快速恢复到上一个稳定版本。

1.6 课程路线图

本课程共 30 章，分为四个模块：

• 基础篇（第 1-8 章）：服务边界与索引映射基础、版本号设计、事件溯源与索引同步。
• 兼容设计篇（第 9-18 章）：向前/向后兼容策略、字段降级、映射版本化、滚动升级模式。
• 实战篇（第 19-26 章）：基于 Elasticsearch 的映射版本管理、多服务协调、冲突解决、监控与告警。
• 进阶篇（第 27-30 章）：跨数据中心索引映射、大规模集群的版本治理、未来趋势。