2. 索引版本概念：版本号定义、版本在索引生命周期中的作用、版本与数据一致性的关系

2.1 版本号定义

在倒排索引架构中，版本号是一个单调递增的全局或分片级标识符，用于唯一标记索引在某一时刻的逻辑快照。版本号不是简单的数字累加，而是承载了索引变更的时序与因果信息。

2.2 版本在索引生命周期中的作用

版本号贯穿索引的创建、写入、合并、刷新、归档、删除全生命周期，是索引状态机转换的核心驱动因子。

2.3 版本与数据一致性的关系

版本号是分布式搜索引擎实现最终一致性和读己之写的核心机制。通过版本号，系统可以在无锁情况下判断数据的新旧，避免更新丢失和脏读。

2.3.1 乐观并发控制

倒排索引的写入通常采用乐观锁策略：客户端在更新文档时携带当前版本号，服务端比对版本号后决定是否执行更新。

// 伪代码：基于版本号的乐观并发更新
boolean updateDocument(String docId, Document newDoc, long expectedVersion) {
    // 1. 读取当前文档版本
    long currentVersion = indexReader.getVersion(docId);
    
    // 2. 版本比对
    if (currentVersion != expectedVersion) {
        // 版本冲突，拒绝更新
        throw new VersionConflictException("版本不匹配: 期望 " 
            + expectedVersion + ", 实际 " + currentVersion);
    }
    
    // 3. 版本号递增，执行写入
    long newVersion = currentVersion + 1;
    indexWriter.update(docId, newDoc, newVersion);
    return true;
}

2.3.2 版本冲突处理策略

2.4 版本号与索引快照的一致性模型

在分布式搜索系统中，版本号还用于构建全局一致性快照。当客户端发起一次搜索请求时，系统需要保证所有分片返回的数据来自同一个逻辑时间点。

2.5 版本号设计的最佳实践

• 单调递增且不回退：版本号必须严格递增，不能因为节点重启或故障而回退。建议使用 AtomicLong 或数据库自增序列。
• 携带时间戳信息：在版本号中嵌入时间戳（如高位存时间戳，低位存序列号），便于排查问题和做时间范围查询。
• 分片级隔离：每个分片维护独立的版本号序列，避免全局锁竞争。协调节点通过分片版本号做一致性裁决。
• 版本号持久化：版本号必须写入事务日志或元数据文件，确保节点重启后版本号不丢失、不重复。
• 版本号溢出处理：64-bit 版本号理论上不会溢出，但如果使用 32-bit，需要设计回绕策略或定期重置。