WAL
WAL 子系统位于 include/raftpp/raftor/wal/，为 Raftor 提供持久化日志、硬状态和配置状态。
WALWALStorageWALConfigSegmentManagerWALIndexMetadataStore
WAL 负责：
- 追加日志条目
- 保存
HardState - 保存
ConfState - 保存 Raftor peer address book
- 读取日志区间
- 执行压缩与快照应用
- 恢复已有 WAL 文件
- 追加的 entries 必须与当前
last_index连续。 HardState、ConfState和日志索引必须保持一致。- 恢复时会回放已有 segment 并重建索引。
WALStorage
Section titled “WALStorage”WALStorage 基于 WAL 实现 Storage 接口，额外提供：
SetHardState()Append()Compact()ApplySnapshot()Sync()LocalSnapshot()LogSizeBytes()IsInitialized()GetPeerAddresses()/SetPeerAddresses()UpsertPeerAddress()/RemovePeerAddress()SnapshotIndex()
IsInitialized() 通过 ConfState.voters 是否非空判断存储是否已完成初始集群配置写入。
Peer 地址簿
Section titled “Peer 地址簿”WAL 元数据持久化 peer 地址簿。
- 首次引导时，地址簿来自
initial_peers；单节点引导时写入当前节点的node_id和listen_addr。 - 节点重启且 WAL 已初始化时，Raftor 会从 WAL 读取 peer 地址，而不是重新使用
initial_peers。 UpdateNodeAddress(id, addr)会通过普通日志提交地址变更；应用后调用UpsertPeerAddress()并更新传输层 peer。RemoveNode(id)对应的配置变更应用后会调用RemovePeerAddress()并移除传输层 peer。
运行期地址变化应通过 Raftor API 提交，不能只修改重启参数。
WALStorage 在内存中维护快照副本，ApplySnapshot() 时：
- 先更新内存中的快照对象。
- 再调用底层
WAL::ApplySnapshot()。
Term(idx) 优先检查快照元数据，可正确处理索引等于快照索引的查询。
I/O 后端
Section titled “I/O 后端”WALConfig.io_backend 支持：
AutoPosixIoUring
其中：
Auto表示由实现自动选择可用后端。IoUring仅在 Linux 且系统支持liburing时可用。
可通过以下接口查询最终选择结果：
EffectiveIoBackend()IoBackendNote()
segment_size
Section titled “segment_size”单个 segment 文件的最大大小，默认 64MB。
write_buffer_size
Section titled “write_buffer_size”批量写入缓冲区大小，默认 4MB。
sync_on_write
Section titled “sync_on_write”是否在每次写批次后同步到磁盘，默认 true。
preallocate
Section titled “preallocate”是否预分配 segment 文件，默认 true。
uring_queue_depth
Section titled “uring_queue_depth”IoUring 后端的提交队列深度。
WAL::Open() 会根据目录内容打开或创建 WAL，并执行恢复流程：
- 读取元数据
- 回放 segment
- 重建索引
- 恢复
HardState与ConfState - 恢复 peer address book 与快照索引
节点重启后应继续使用原有 data_dir，否则进入不同的恢复路径。
WALStorage::LocalSnapshot() 返回最新本地应用快照。Raftor::Create() 在创建 RawNode 前先将该快照恢复到状态机，并以快照 index 作为初始 applied index。