直接写Raft节点易卡在状态机同步，因心跳与选举超时未分离、日志索引起点不统一、RPC响应字段处理错误；极简实现需内存日志、禁持久化与快照、固定心跳100ms、选举超时随机150–300ms、HTTP模拟RPC、严格校验prevLogIndex和prevLogTerm。
为什么直接写 Raft 节点容易卡在状态机同步上
很多人一上来就猛啃论文、画状态图，结果发现连「怎么让三个节点知道谁是 Leader」都跑不通。核心卡点不在共识逻辑本身，而在三件事没对齐：心跳超时时间不一致、日志索引从 0 还是 1 开始没约定、AppendEntries 返回的 term 和 success 没被正确处理。这些细节不统一，节点间会无限来回切换角色，日志永远追不齐。
极简版要先砍掉所有非必要模块：不要持久化（用内存日志）、不要快照、不实现 InstallSnapshot、客户端请求只走 Leader 转发（不处理重定向）。目标是让三个节点能稳定选出 Leader，并成功复制一条日志。
raft.Node 结构体里必须带的五个字段
别堆字段，够跑通选举和日志复制就行。下面这五个是底线：
-
currentTerm：当前节点认为的任期号，初始化为 0 -
votedFor：本任期投给谁（nil表示未投票） -
logs：[]LogEntry，内存日志，首条日志索引设为 1（和 Raft 论文一致，避免 off-by-one） -
commitIndex和lastApplied：都初始化为 0；前者由 Leader 维护，后者在 Follower 本地推进
别加 state 枚举（Leader/Candidate/Follower），用行为判断更轻量：比如收到更高 term 就自降级，能发 AppendEntries 就当自己是 Leader —— 状态只是副产物。
心跳超时和选举超时不能用同一个定时器
这是最常被抄错的地方。很多 demo 把两者混成一个 timeout 变量，导致 Follower 在心跳窗口内误触发选举。必须分开：
- 心跳超时（Leader 发送
AppendEntries的间隔）：固定值，比如 100ms - 选举超时（Follower 等待心跳的上限）：随机区间，比如 150–300ms
每次收到有效 RPC（AppendEntries 或 RequestVote）都要重置选举定时器；Leader 则每 100ms 触发一次心跳。用 time.AfterFunc 配合 Reset() 控制，别用 time.Tick —— 它无法动态调速，选举超时需要随机抖动防活锁。
测试时用 net/http 模拟 RPC 最快
不用立刻上 gRPC 或自定义 TCP 协议。每个节点起一个 http.Server，暴露两个 handler：
-
POST /request_vote处理RequestVote请求 -
POST /append_entries处理AppendEntries请求
请求体用 JSON，字段严格对应论文：包括 term、leaderId、prevLogIndex、prevLogTerm、entries、leaderCommit。响应也只返回 term、success、matchIndex（可选）。这样三节点用 http.Post 互调，5 分钟就能连通，比调试 socket 字节流快得多。
真正难的不是代码长度，而是日志匹配检查那几行：prevLogIndex 是否越界、logs[prevLogIndex].Term 是否等于 prevLogTerm —— 这里数组访问必须加边界判断，否则一启动就 panic。
