区块链原理 / 系统课时
根据节点日志定位最终性停滞
根据节点日志定位最终性停滞
区块高度长时间停在 H=120,不能直接判定为共识死锁。把四名验证者在相同高度和轮次的提议、预投票、预提交及锁定日志对齐后,可以判断是未凑齐法定投票权、消息传播太慢,还是锁定规则使新提议无法获得支持,并据此选择验证方法。
学习目标
- 按高度、轮次和消息阶段汇总多节点共识证据。
- 用真实投票权重区分票数不足、消息迟到和锁定分裂。
- 为三种停滞现象选择对应修复手段并验证高度恢复推进。
先确定停在哪个共识阶段
以 CometBFT/Tendermint 风格的四验证者测试网为例,A、B、C、D 投票权均为 1,总权重 4。有效法定人数必须严格超过总投票权的三分之二,因此同一高度、同一轮次、同一非空区块获得至少 3 权重的 Precommit,才具备进入提交阶段的投票证据。
先在至少两个节点上确认 height=120 是否始终不变,再观察 round 是否从 0 增至 1、2。若轮次递增而高度不变,通常说明各轮未形成可提交证据;若已有针对同一区块的足额 Precommit,却未进入下一高度,应进一步核对区块数据是否已收到、提交处理和应用层执行,而不是继续归咎于缺票。
Propose阶段:检查预期提议者是否发出提议、其他节点是否在超时前收到完整区块。Prevote阶段:按区块 ID 分组计票;nil是实际投出的空票,不等于没有收到消息。Precommit阶段:只合计同一块、同一轮次的预提交;不同轮次的票不能相加。
把多节点日志整理成可比证据
不同 CometBFT 版本的原生日志字段、措辞和输出级别可能不同。可从结构化日志、共识状态、WAL 和 P2P 记录中提取信息,统一成下表所示的诊断字段;这些名称是分析用字段,不冒充软件原生固定键。
| 诊断字段 | 用来回答的问题 |
|---|---|
height、round、step、proposer |
卡住的是哪一轮、哪一步,由谁提议? |
validator、voteType、blockId、power |
哪些人对哪个块投了哪种票,权重多少? |
sentMs、seenMs、peerId |
票未发送、发出后丢失,还是在接收端晚到? |
lockedBlock、lockedRound、polRound |
节点为何拒绝给新提议投票,是否存在更高轮证明? |
timeoutReason、本地阶段进入时间 |
是提议超时还是等待投票超时? |
实际整理时,先从该高度的验证者集合取权重,按 (height, round, voteType, validator) 核对唯一投票,再分别计算每个区块的收到权重;自投票与网络收到的同一签名只能算一次。如果同一验证者在同一高度、轮次、投票类型下出现不同区块的有效签名,应单独保留双签证据,不得当作普通重复记录丢弃。
不同节点看到的票集可能不同,某节点没有 D 的日志只能证明该节点未观测到 D,不能证明 D 没有发送。跨机比较毫秒延迟前应校准时钟;测试环境可把时钟偏差控制在 50ms 内并记录偏差。
用最小脚本重建三个现场
下面是 Python 3 标准库可运行示例。三组数据分别代表独立的 H=120、R=1 诊断现场,时间均以本轮开始为零点。前两组统计 Precommit,最后一组统计 Prevote;2000ms 只是人为选取的日志观察截点,不是共识协议的固定提交截止时间。
from collections import defaultdict
power = {"A": 1, "B": 1, "C": 1, "D": 1}
quorum = 2 * sum(power.values()) // 3 + 1
window_ms = 2000
# 场景、验证者、阶段、投票块、发送毫秒、接收毫秒、锁定块
rows = [
("missing", "A", "precommit", "X", 600, 680, None),
("missing", "B", "precommit", "X", 610, 700, None),
("missing", "C", "precommit", "nil", 615, 750, None),
("late", "A", "precommit", "X", 600, 650, None),
("late", "B", "precommit", "X", 610, 720, None),
("late", "C", "precommit", "X", 720, 3400, None),
("lock", "A", "prevote", "X", 900, 960, "X"),
("lock", "B", "prevote", "X", 910, 970, "X"),
("lock", "C", "prevote", "Y", 920, 990, None),
("lock", "D", "prevote", "Y", 930, 1000, None),
]
def tally(items, until_ms=None):
counts = defaultdict(int)
seen = set()
for _, validator, _, block, _, received, _ in items:
if (until_ms is not None and received > until_ms) or validator in seen:
continue
seen.add(validator) # 示例数据中,同一阶段每人只有一张有效票
counts[block] += power[validator]
return counts
missing = [r for r in rows if r[0] == "missing"]
late = [r for r in rows if r[0] == "late"]
lock = [r for r in rows if r[0] == "lock"]
m = tally(missing)
absent = sorted(set(power) - {r[1] for r in missing})
print(f"缺票:Precommit X={m['X']}/4,nil={m['nil']}/4,未观测={','.join(absent)};门槛={quorum}/4")
early, all_votes = tally(late, window_ms), tally(late)
delayed_ms = next(r[5] - r[4] for r in late if r[1] == "C")
print(f"迟到:2秒内 Precommit X={early['X']}/4,后来观测 X={all_votes['X']}/4;C 耗时={delayed_ms}ms")
v = tally(lock)
locked = "/".join(r[1] for r in lock if r[6] == "X")
print(f"锁定:Prevote X={v['X']}/4,Y={v['Y']}/4;锁定 X={locked};门槛={quorum}/4")预期输出:
缺票:Precommit X=2/4,nil=1/4,未观测=D;门槛=3/4
迟到:2秒内 Precommit X=2/4,后来观测 X=3/4;C 耗时=2680ms
锁定:Prevote X=2/4,Y=2/4;锁定 X=A/B;门槛=3/4结果分别表明:缺票场景在本地只看到 X 的 2 权重预提交;迟到场景直到收到 C 的消息才观察到 3 权重;锁定场景预投票被 X、Y 各分走 2 权重。脚本只计算已观察证据,不能据此断言失联、恶意双签或网络分区。真实生产日志还必须验证签名与成员权重,并且不可把两个接收节点的重复记录相加。
沿时序识别三类根因
在锁定场景中,设 A、B 在 R=0 已有对 X 的有效锁定,R=1 的提议者又提出 Y,而没有满足解锁条件的更高轮有效投票证明。A、B 继续 Prevote X,C、D Prevote Y,因此 Y 只有 2/4。不要仅凭日志里出现 lockedBlock=X 就认定死锁,还要核对 lockedRound、提议中的证明轮次和对应投票证据。

可按下列证据做排查分流:
| 观察到的证据 | 首要核对对象 | 不能贸然下的结论 |
|---|---|---|
同一块 Precommit 始终低于 3/4 |
未观测验证者的本地签名、节点状态、P2P 连接 | 不能直接说对方没有投票 |
| 发出较早、接收时间显著滞后 | 传播路径、队列积压、丢包重传、区块体接收 | 不能直接说法定人数配置错误 |
Prevote 分叉且锁定块不同于新提议 |
锁定轮次、提议证明、区块有效性检查 | 不能直接清除锁定状态强行提交 |
修复后如何证明最终性恢复
- 缺票:检查未观测验证者是否在线、签名器是否正常、是否使用了当前高度正确的验证者集合;对照发送端签名记录与至少两台接收端记录,确认是未产生投票还是传播中断。
- 消息延迟:比较
sentMs与seenMs,再检查 P2P 链路和区块传播耗时。CometBFT 配置中的timeout_propose、timeout_propose_delta与提议等待有关,例如3s、500ms;不要把增加它们当作所有预提交延迟的通用修复。 - 锁定分裂:复核 R=0、R=1 的
Prevote证明、锁定轮次及提议中的POLRound,检查验证者是否按同一规则验证区块。禁止手动清除锁定或私钥签名状态来换取表面的高度增长。 - 验收:在同一高度和同一轮次收集对同一非
nil区块超过 2/3 权重的有效Precommit,随后验证节点从 H=120 进入 H=121;对照各节点提交区块 ID 一致,并检查应用层执行完成。若票已足额但仍停住,应转查区块获取、落盘和应用提交路径。
协议状态转换和锁定条件可对照 CometBFT 共识规范,超时参数以所部署版本的 配置文档 为准。最终验收记录应同时保存高度、轮次、区块 ID、签名投票权重和消息到达时间,避免把一次暂时升高误判为持续恢复。