C++实现Raft选主的核心是原子更新currentTerm、votedFor、state三字段，并配合150–300ms随机选举超时与严格RequestVote校验逻辑，否则必现双主、反复选举或卡死。
直接说结论：C++ 实现 Raft 选主流程，核心不是写一堆 RPC 或网络层，而是先稳住 currentTerm、votedFor、state 三个字段的原子更新逻辑，再配好随机超时与 RequestVote 投票规则。否则哪怕网络通了，也会出现双主、反复选举或卡在 Candidate 不动。
如何让 Follower 正确触发选举（Election Timeout）
超时不是固定值，必须是 150–300ms 区间内的随机数，且每次重置都得重新生成——这是防脑裂的关键。用 std::uniform_int_distribution 配合 std::mt19937 是最稳妥做法，别用 rand() 或系统时间做种子。
触发条件只有两个：state == Follower 且自上次收到 AppendEntries 或 RequestVote 后超时。注意：收到任何合法 RPC（哪怕 term 更小）都要重置定时器，但不能更新自己的 currentTerm；只有收到更大 term 的 RPC 才要立即升级 term 并转为 Follower。
- 常见错误：超时后直接
state = Candidate，没先currentTerm++→ 导致投票请求带旧 term，其他节点拒绝 - 常见错误：心跳包只发给已知 peers，漏掉新加入节点 → 新节点因收不到心跳而提前触发选举
- 性能影响：超时太短（如固定 100ms）会导致频繁选举；太长（如 500ms）则故障恢复慢，尤其对低延迟 KV 场景敏感
RequestVote RPC 的参数与响应逻辑怎么写才安全
RequestVote 不是“请投我一票”的礼貌请求，而是带严格校验的状态同步信号。接收方必须按顺序检查：term <= candidateTerm → votedFor == -1 || votedFor == candidateId → logIsUpToDate()。三者缺一不可。
立即学习“C++免费学习笔记（深入）”；
其中 logIsUpToDate() 判断不能只比日志长度，必须比较最后一条已提交日志的 term 和 index：若候选者日志的最后 term 更大，或 term 相同但 index 更大，则认为其日志“不落后”。这个逻辑漏掉，就会选出一个缺少已提交日志的 Leader，后续 commit 语义崩坏。
- 典型错误：把
votedFor设为int但初始化为0，导致节点 0 永远无法被二次投票 → 实际应初始化为-1 - 典型错误：响应中返回
term却没同步更新本地currentTerm→ 接收方下次发请求仍用旧 term，被拒 - 兼容性注意：etcd v3.5+ 要求
RequestVote响应必须包含term字段，否则老 client 可能误判为拒绝
为什么 Candidate 收到多数票后不能立刻切 Leader
收到过半票只是必要条件，不是充分条件。必须确保：① 自己的 currentTerm 未被更高 term 的 RPC 覆盖；② 在切换前已向所有 peers 发出至少一轮空 AppendEntries（即心跳），且至少有一条被确认——这是为了快速建立权威、阻止其他节点在同一 term 内发起新选举。
更关键的是：切换瞬间要清空所有 pending 的投票计数器，并广播 AppendEntries 带上自己的 leaderId 和当前 term。Follower 收到后必须立即设 votedFor = -1（放弃本 term 再投票权），并重置自己的 election timeout。
- 容易踩的坑：切 Leader 后没停掉自己的选举 timer → 仍可能在几毫秒后再次发
RequestVote，造成 self-vote 冲突 - 容易踩的坑：没在
BecomeLeader()中重置nextIndex[]和matchIndex[]数组 → 后续日志复制从错误位置开始，follower 拒绝追加 - 调试建议：在
ReceiveAppendEntries入口加if (msg.term > currentTerm) { currentTerm = msg.term; state = Follower; }，否则 stale leader 可能长期不退位
真正难的从来不是发多少次 RPC，而是每个状态跃迁点上，currentTerm、votedFor、state、leaderId 这四个变量是否始终满足 Raft 论文 Table 1 的约束条件。漏掉任意一个检查，集群就可能进入不可预测的中间态——比如两个节点互相认为自己是 Leader，但谁都不接受对方的心跳。
