元宿six1. 为什么 6.824 要把 Raft 放在这个位置
1.1 单机不行，主备也有天花板
分布式系统课往前推进的过程，其实是一个不断"拆掉天真方案"的过程。你一开始会觉得，服务器挂了怕什么，多准备一台备机，主备做状态同步不就完了？但主备方案有个绕不开的前提：主节点和备节点之间必须存在一条可靠的、不会产生歧义的通信通道。现实里这条通道经常以网络分区的方式出问题——主节点没挂，只是和备节点联系不上了，备节点等不到心跳就接管服务，此时旧主节点恢复通信，两个"主"同时接受写请求，状态立刻分裂。
Raft 不是从零发明的新东西，它要解决的就是这个场景下的"分布式共识"：让一组服务器即使发生部分节点故障、网络分区，也能对外表现得像一台服务器。MIT 6.824 的 LEC 6 是正式进入 Raft 的第一讲，它的任务是把整个算法的主干框架、设计动机、关键机制全部交代清楚，让后面动手实现的人有一个完整的心理模型。
这一讲最容易被低估的地方是：它表面上在讲协议细节，实际上是在教你怎么把"少数服从多数""日志顺序一致"这些抽象概念翻译成具体的工程规则。我第一次看的时候觉得每个机制分开都懂，合在一起就晕，后来反复消化才发现，问题出在我没有理解这些机制之间互相咬合的关系。这篇内容就是把我消化后的完整思路整理出来。
1.2 复制状态机：共识问题里的"公理"
Raft 解决的问题可以用一句话概括：让所有服务器按照相同顺序执行相同命令。这里说的不是把每个服务器的内存数据直接同步——数据量太大、依赖太多，直接同步不现实。真正可行的方法是复制状态机：每个服务器都运行同一个确定性程序，只要输入的命令序列一致，最终状态就一致。
举个生活化的例子。假设有 5 台服务器共同维护一个银行余额，每个客户端请求都是一条命令："账户 A 给账户 B 转 100 元"。如果 3 台服务器先执行了"转 100"，另外 2 台先执行了"转 50"，那么即使它们最终都执行了这两条命令，结果也会不同。Raft 要保证的就是：任何一条命令在集群中执行前，先在所有服务器上形成一条全局唯一的、有序的日志。
所以论文里反复强调的"日志一致"不是最终目的，而是手段。Raft 第一讲给出的图景很清晰：客户端命令先追加到 leader 的日志，然后复制到其他节点，等多数派都保存了这条命令，再把它提交并应用到状态机。整个算法的所有规则，几乎都是在保护这条日志不被写乱、不被覆盖错。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Raft 对 Paxos 的取舍：理解优先是怎么变成工程优势的
2.1 Paxos 难懂，不是学习者的错
6.824 讲到共识算法时，不可能绕过 Paxos。很多教材会把 Paxos 作为分布式共识的理论基石，然后告诉你 Raft 是"更易理解的 Paxos"。但 LEC 6 的重点不是让你欣赏 Paxos 的优雅，而是明确告诉你：Paxos 的抽象程度太高，导致实际工程实现时容易出现隐蔽错误。
Paxos 需要区分 proposer、acceptor、learner 等多种角色，还要处理两阶段提交、prepare 和 accept 的交叉请求。理论上它是正确的，但人的直觉很难覆盖所有边界情况。一旦在网络延迟、节点故障叠加时，很多实现者根本无法判断自己的实现是否偏离了协议。Raft 论文里做过一个实验，让两组学生分别学 Paxos 和 Raft，然后回答关于协议行为的问题，Raft 组的正确率明显更高。
这个"可理解性优先"的选择看起来像是降低学术门槛，实际上是工程上的明智决策。一个协议再强大，如果实现者总是做错，那它在真实系统中就不可靠。Raft 把目标调整为"让大多数工程师第一次实现就能正确"，这是一个非常务实的取舍。
2.2 一个大问题拆成五个小问题
Raft 论文最漂亮的动作之一，是把共识问题模块化。整个算法被拆成五个几乎可以独立推理的子问题：leader 选举、日志复制、安全性、集群成员变更、日志压缩。其中前两个是 LEC 6 的核心，安全性虽然这一讲会点到关键约束，但更严密的证明通常放在 Raft 的第二讲里展开。
这种拆法直接影响了实现方式。你不需要一次性把整个 Raft 塞进脑子里，而是可以先实现一个"能选主、能复制日志"的最小版本，跑通后再逐步补上安全性细节。课程安排也是顺着这条线走的——第一讲让你建立对协议主干的直觉，第二讲再深入处理那些"错误场景下协议如何自保"的细节。
理解这次拆解本身，比背下任何一条协议规则都重要。因为当你实现时遇到 bug，排查的第一步永远是问自己：这个 bug 属于选举问题、复制问题还是安全性问题？定位到子问题，你才知道该去翻论文的哪个章节。
3. 三个角色与任期：Raft 的结构骨架
3.1 服务器状态机：Follower、Candidate、Leader
Raft 里的每台服务器在任意时刻都处于三种角色之一：跟随者 Follower、候选人 Candidate、领导者 Leader。在稳定的运行状态下，整个集群只有一个 Leader，其余全是 Follower。Follower 只做两件事：接收来自 Leader 的心跳和日志，以及参与投票。Candidate 是 Follower 在选举超时后变成的临时角色，目的是发起一轮选举争取成为 Leader。
角色转换的方向比大多数人想象得更简单。所有节点启动时都是 Follower；如果选举超时且没有收到 Leader 的心跳，就自增任期并变成 Candidate，发起投票；如果 Candidate 获得多数派选票，就成为 Leader；任何一个节点——包括 Leader——发现自己收到的消息里的任期比自己大，就要立即降级为 Follower。
这种"无条件让位"的设计初看有点粗暴，但它解决了分布式系统里最难处理的"陈旧角色"问题。网络分区中的旧 Leader 可能还觉得自己是 Leader，但只要它发出的消息带有旧任期，新任期节点就会拒绝，它就无法再影响集群。正是依靠任期这个简单的数字标尺，Raft 避免了主备方案中常见的脑裂失控。
3.2 Term 任期：Raft 里的逻辑时钟
没有全局时钟的分布式系统，如何判断消息的新旧？Raft 给出的答案是任期 Term。任期是一个单调递增的整数，每次开始一轮新的选举，任期就加一。任期像一场足球赛的"第几个半场"：一个任期通常从选举开始，如果选举成功，这个 Leader 就掌管整个任期，直到它失联或发现自己已经过期。
所有 RPC 消息都会携带发送方的 currentTerm。收到消息的节点会比较这个值和自己的 currentTerm：如果对方的任期更大，说明自己已经落伍，必须立刻更新任期并降级为 Follower；如果对方的任期更小，说明对方已经被淘汰，直接拒绝这条消息。
这个设计非常像小说里的"皇帝年号"——你用哪个年号，就代表你处在哪个时间段。任期让所有节点对"现在是什么时代"有一致认识，即使它们之间没有任何物理时钟同步。我强烈建议你在理解任何 Raft 规则前，先把任期当成一个会传染的全局时间戳，这样后面的 RPC 处理逻辑都会变得顺理成章。
3.3 全协议只有两条 RPC，这是刻意的减法
Paxos 需要设计多套消息交互，而 Raft 把节点间通信压缩到两条 RPC：
| RPC 名称 | 发起方向 | 携带的关键信息 | 典型触发场景 |
|---|---|---|---|
| RequestVote | Candidate -> 其他节点 | term、candidateId、lastLogIndex、lastLogTerm | 选举时拉票 |
| AppendEntries | Leader -> Follower | term、leaderId、prevLogIndex、prevLogTerm、entries[]、leaderCommit | 心跳、日志复制 |
这里有个容易被忽略的点：心跳也是 AppendEntries，只是 entries 为空数组。这样做的好处是，Leader 维持权威和复制新日志用的是同一种消息、同一套处理流程，Follower 不需要为"心跳"单独维护一套逻辑。协议设计的优雅之处往往不是增加机制，而是减少机制。
每条 RPC 的响应也会带上接收方当前的 term。如果发送方发现响应里的 term 比自己大，说明自己已经过时，应该立刻退位。这一来一回的 term 检查，就是 Raft 所有安全性的地基。
4. 选主：依靠随机超时打破"谁先说话"的僵局
4.1 一次选举的完整流程
Raft 的选举机制可以从一场班级选班长的场景理解。平时班长（Leader）定期吼一嗓子"我还在"，其他同学听到后继续安静自习；如果某个同学超过一段时间没听到班长的声音，他就有理由怀疑班长可能出了问题，于是站起来大喊"我要当班长，请支持我"。
具体流程是这样的：Follower 会维护一个选举超时定时器，每次收到 Leader 的 AppendEntries 心跳就重置定时器。如果定时器到期仍然没有任何来自 Leader 的消息，Follower 认为自己可能被 Leader 遗忘了，就执行以下动作：先把 currentTerm 加一，把自己变成 Candidate，投自己一票，然后并行向所有其他节点发送 RequestVote RPC。
Candidate 会等待回应，直到出现三种情况之一：获得超过半数节点的选票成为 Leader；收到一个任期不低于自己的 Leader 的心跳，说明别人已经当选，自己降级为 Follower；选举超时再次触发，说明本轮没有选出 Leader，重新发起新一轮选举。这里注意，Candidate 在等待投票结果时如果自己的选举超时也到期了，它可以再次自增任期并重新发起选举，这不是错误行为，而是协议允许的重试。
4.2 为什么选举超时必须是随机的
如果说 Raft 选主有一个最容易被小看的机制，那一定是选举超时的随机化。假设所有 Follower 的选举超时都是固定相同的值，那么当 Leader 故障后，所有 Follower 几乎会在同一时刻发现心跳中断，同时变成 Candidate，同时向所有人拉票——结果就是每个人都投了自己，票数分散在多个候选人之间，没有任何人能获得多数派，于是又同时超时、再次选举，形成一个死循环。
解决办法出奇地简单：让每个节点的选举超时从一个区间里随机取值，比如论文里常用的 150 到 300 毫秒。这样所有 Follower 不会在同一时刻超时，总有一个"最先着急"的节点先发起选举，而其他节点大概率还没超时，会响应它的投票请求。Raft 用随机化制造了一个天然的错峰机制，避免了对手同时起跑的问题。
实际工程中，选举超时的最小值必须明显大于心跳间隔，通常要留出 5 到 10 倍的余量。如果心跳是 50 毫秒一次，选举超时的最小值至少设在 500 毫秒以上，否则一次正常的 RPC 网络抖动就可能导致节点误判 Leader 故障，引发不必要的选举。
4.3 不是谁嗓门大谁当选：候选人必须日志够新
选举不是简单的"先到先得"。Raft 规定，一个 Candidate 想拿到某个节点的选票，它的日志必须"不落后于"投票节点的日志。具体来说，投票节点会比较 Candidate 发送来的 lastLogTerm 和 lastLogIndex，如果 Candidate 的最后一条日志任期更新，或者任期相同但日志索引更大，才认为这个 Candidate 的日志足够新，同意投票。
这个条件初看只是选举规则的一部分，实际上它是整个 Raft 安全性的命门。如果日志落后的节点也能当选 Leader，它可能会用自己的短日志覆盖已经提交的旧日志，导致已经执行过的命令被抹掉。Raft 之所以敢让新 Leader 强制覆盖 Follower 的日志，正是因为它通过选举限制保证了新 Leader 一定拥有所有已提交的日志条目。
很多刚开始实现 Raft 的人会在这个条件上偷懒，只在 RequestVote 里检查任期，不检查日志的完整程度，结果就是各种诡异的日志丢失问题。这部分在 LEC 6 可能只是一带而过，但等你动手写代码时会发现，它值得你反复默念。
5. 日志复制：AppendEntries 的一致性检查是整个协议的命门
5.1 一条命令从客户端到提交的完整路径
日志复制是 Raft 日常工作的主流程，它的路径非常清晰。客户端把命令发送给 Leader，如果命令误发到 Follower，Follower 会告知客户端当前 Leader 的地址，让客户端重发。Leader 收到命令后，先把命令包装成一条日志条目，记录下当前的任期和日志索引，追加到自己的日志末尾。
接着 Leader 向所有 Follower 发送 AppendEntries RPC，里面携带这批待复制的新日志条目。每个 Follower 在确认日志可以安全追加后，把条目写入自己的日志，并返回成功。Leader 一旦确认超过半数的节点都保存了这条日志，就把这条日志标记为已提交，然后将其应用到自己的状态机，最后把执行结果返回给客户端。
这里有个容易混淆的点：Leader 提交一条日志，并不意味着所有节点都立即应用了它。Follower 应用日志的时机是由 Leader 通过 AppendEntries 里的 leaderCommit 字段告知的。Leader 会把自己的 commitIndex 随心跳或日志复制消息广播出去，Follower 收到后，把自己的 commitIndex 推进到 min(leaderCommit, 自己日志的最后索引)，然后才能把新提交的日志应用到状态机。
5.2 prevLogIndex 和 prevLogTerm 到底在防什么
AppendEntries 中最重要的字段不是那些待复制的日志条目本身，而是请求里的 prevLogIndex 和 prevLogTerm。它们的意思是：Leader 请求 Follower 把新日志条目追加到 prevLogIndex 之后，但前提是 Follower 在 prevLogIndex 处的日志条目任期与 prevLogTerm 一致。如果校验失败，Follower 直接返回失败。
这个检查是 Raft 日志匹配性质的核心。日志匹配性质说的是：如果两个不同节点上的日志在同一个索引位置拥有相同任期的条目，那么这两个日志从开头到这个索引的所有前缀都完全一致。为什么能保证这一点？正是因为在每次追加新条目之前，Leader 都要求 Follower 确认前缀一致。
这个机制的重要性怎么强调都不过分。它防止的是一种非常隐蔽的错误：如果 Follower 在不检查前缀的情况下盲目追加，两条日志可能在前半部分已经不一致的情况下继续往后增长，而且双方都无法察觉。最终提交的日志虽然从中间某处开始一致，但前面的历史已经是两个故事了，这会造成灾难性的状态分叉。所以一致性检查不是性能优化，而是正确性的基石。
5.3 日志冲突时，Leader 如何让 Follower 回到正轨
如果 Follower 的日志和 Leader 不一致，AppendEntries 的一致性检查就会失败。Leader 这时需要找到 Follower 与自己在哪个位置开始分叉，然后把分叉点后面的日志全部删掉，再重新发送 Leader 的日志。
最朴素的做法是：Leader 为每个 Follower 维护一个 nextIndex，表示下一个要发送的日志索引。初始时 nextIndex 设为 Leader 日志长度加一。如果 AppendEntries 因为 prevLogIndex 不匹配而失败，Leader 就把 nextIndex 减一，再重试。如此循环，直到回退到 Leader 与 Follower 最后一个一致的位置，然后从那里开始覆盖。
举个具体例子。假设 Leader 的日志是 [idx1 term1, idx2 term2, idx3 term4]，某个 Follower 的日志是 [idx1 term1, idx2 term3]，那么 Leader 第一次尝试从 idx2 开始复制时，Follower 检查 prevLogIndex=1、prevLogTerm=1，虽然一致，但要覆盖 idx2 的 term3 会删除冲突条目，这个过程由新日志的一致性检查保证。实际上在这个例子中，Leader 会发送 prevLogIndex=1 的 AppendEntries，里面带着 idx2 term2、idx3 term4，Follower 发现自己的 idx2 任期 term3 与 Leader 的 term2 不同，就会删除 idx2 及之后的所有条目，然后追加 Leader 发来的内容。
这里有个重要的安全边界：Raft 只允许覆盖未提交的日志条目，绝不允许覆盖已经提交的条目。因为任何已提交的条目必然存在于多数派节点上，而新 Leader 是经过多数派选举出来的，这两个多数派一定有交集，所以新 Leader 必定包含已提交条目，也就不会去删除它们。这个多数派交集论证是 Raft 安全性的基本逻辑。
5.4 新 Leader 不能直接提交旧任期的日志
这是 LEC 6 里我认为最容易踩坑、也最值得展开的一点。按照直觉，一条日志条目只要被复制到了多数派节点上，就可以被 Leader 标记为提交。但 Raft 加了一个反直觉的限制：新当选的 Leader 不能只凭多数派复制就提交旧任期的日志条目。
原因是，新 Leader 不知道旧 Leader 曾经把哪些日志复制到了哪些节点，如果它直接根据多数派计数来提交旧任期条目，可能出现一种危险的情况：旧 Leader 在一个网络分区内把某个旧条目复制到了少数节点并误以为可以提交，但随后新 Leader 在另一个分区当选，它的日志里没有这个旧条目，于是向多数派复制了另一条冲突日志。如果旧 Leader 的错误"提交"被当作事实，那么这条从未真正安全的日志就可能被后续的新 Leader 覆盖删除，造成已提交日志丢失。
Raft 的实际做法是：Leader 只有在自己的当前任期内有日志条目被复制到多数派节点时，才能推进 commitIndex，并且一旦当前任期的某条日志提交了，它前面的所有旧任期日志会一并被间接提交。原理其实很简单：如果当前任期的条目 X 被安全提交，意味着多数派节点的日志中都包含 X，而 AppendEntries 的前缀一致性保证了这些节点也同时包含了 X 之前的全部日志，所以 X 之前的旧条目也已经在多数派节点上，可以被安全提交。
很多实现者在处理这个问题时会想走捷径，直接根据 Follower 返回的 matchIndex 推进 commitIndex。结果就是论文 5.4.3 节里描述的那个经典反例：一个节点在旧任期看似获得了多数派的复制，但在另一个网络分区中，新 Leader 用不同的日志覆盖了它，导致已提交状态丢失。正确做法是，当选为新 Leader 后，如果不确定之前任期日志的提交状态，通常先在自己的日志末尾追加一个空操作的 no-op 条目，等这个当前任期的 no-op 条目被复制到多数派并提交后，再放心地推进 commitIndex。
6. 从 LEC 6 到动手实现：几个边界问题最容易出错
6.1 持久化范围：丢失 votedFor 比丢日志更危险
如果你是自己实现 Raft，我强烈建议把问题域和"必须持久化什么"一起考虑。分布式共识算法必须假设节点可能随时崩溃并重启，重启后内存里的所有状态都会丢失，所以协议要求三个状态必须持久化：currentTerm、votedFor、日志条目。
currentTerm 和 votedFor 必须持久化，是因为一个节点重启后如果忘记了自己在某个任期已经投过票，它可能在同一个任期里给两个不同的 Candidate 投票，破坏"每任期最多一票"的约束。日志条目必须持久化，是因为已经追加但还未提交的日志，如果丢失，一旦这个节点之后当选 Leader，它可能覆盖其他节点上已经提交的日志。论文里把持久化列为实现安全性的底线，这一讲虽然没有展开崩溃恢复的细节，但你在第一遍读 LEC 6 时就应该理解持久化不是优化，是必需。
实际工程里，顺序很重要：节点在响应任何投票或日志复制 RPC 之前，必须先把自己更新的任期和投票记录写入磁盘。如果先回复再持久化，回复发出后节点突然崩溃，重启后它可能忘记已经投过票，这是非常隐蔽的一致性漏洞。
6.2 RPC 处理里"降级"这个动作要放在最前面
写 RPC 处理函数时，一个很容易出错的地方是处理"任期过期"的方式。标准写法是：收到请求时，先比较请求中的任期和当前任期。如果请求任期更大，把自己的 currentTerm 更新为请求任期，并降级为 Follower；如果请求任期更小，直接返回失败。这个逻辑应该在处理任何具体业务之前执行，而不是在处理完日志后再判断。
为什么要放在最前面？因为 Rafter 的所有状态——包括 commitIndex、投票记录、Leader 身份——都以任期为前提。一个任期过期的节点如果继续处理请求，它可能基于旧任期做出新任期下不该做的决定。更可怕的是，如果节点收到了更高任期的消息却因为代码逻辑问题没有及时降级，两个 Leader 同时存在的时间窗口就会被拉长，这是最容易引发数据覆盖错误的场景。
6.3 心跳间隔与选举超时的取值要留足余量
选主是否频繁发生，很大程度取决于参数配置。如果心跳间隔设得太长，Follower 可能会频繁误判 Leader 故障，导致系统反复进入选举状态，白白消耗带宽。如果心跳间隔太短，网络稍有拥堵，大量心跳就会加剧负载，反而不利于稳定。
我见过不少实现里把心跳设为 100ms、选举超时设为 300ms，这在本地测试没问题，但一旦遇到真实网络抖动就会频繁选举。稳妥的做法是让选举超时的最小值至少是心跳间隔的 5 到 10 倍。例如心跳 50ms，选举超时随机范围可以设在 500ms 到 1000ms 之间。这个余量能够吸收网络延迟的波动，又不至于让 Leader 故障后的恢复时间过长。
6.4 调试时把日志打清楚，尤其是"日志"
最后分享一个实用经验：Raft 调试的困难不在于算法本身，而在于你看不到其他节点内部的状态。建议一开始就为每个节点加上带任期的操作日志，例如每当节点收到 AppendEntries、发起投票、推进 commitIndex 时，都打印出当前任期、日志索引范围和操作类型。这样一旦某个测试失败，你可以从日志里还原出完整的选举与复制时间线，而不是对着一条失败断言瞎猜。
我后来复盘自己做 Raft 的过程时发现，绝大多数 bug 都不是算法原理不懂，而是在某个 RPC 的边界条件下没有严格按照论文走。比如 prevLogIndex 为 0 时怎么处理、commitIndex 推进时是否超出了日志长度、收到比自己任期小的 AppendEntries 是否直接忽略——这些细节每个单独看都很小，合在一起就是正确与错误的全部差距。把 LEC 6 里的每一条规则当成能执行的代码而不是抽象原则，动手写的时候会少走很多弯路。