区块链原理 / 系统课时

根据节点日志定位最终性停滞

根据节点日志定位最终性停滞

区块高度长时间停在 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 只是人为选取的日志观察截点,不是共识协议的固定提交截止时间。

python
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")

预期输出:

text
缺票: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 分叉且锁定块不同于新提议 锁定轮次、提议证明、区块有效性检查 不能直接清除锁定状态强行提交

修复后如何证明最终性恢复

  1. 缺票:检查未观测验证者是否在线、签名器是否正常、是否使用了当前高度正确的验证者集合;对照发送端签名记录与至少两台接收端记录,确认是未产生投票还是传播中断。
  2. 消息延迟:比较 sentMs 与 seenMs,再检查 P2P 链路和区块传播耗时。CometBFT 配置中的 timeout_propose、timeout_propose_delta 与提议等待有关,例如 3s、500ms;不要把增加它们当作所有预提交延迟的通用修复。
  3. 锁定分裂:复核 R=0、R=1 的 Prevote 证明、锁定轮次及提议中的 POLRound,检查验证者是否按同一规则验证区块。禁止手动清除锁定或私钥签名状态来换取表面的高度增长。
  4. 验收:在同一高度和同一轮次收集对同一非 nil 区块超过 2/3 权重的有效 Precommit,随后验证节点从 H=120 进入 H=121;对照各节点提交区块 ID 一致,并检查应用层执行完成。若票已足额但仍停住,应转查区块获取、落盘和应用提交路径。

协议状态转换和锁定条件可对照 CometBFT 共识规范,超时参数以所部署版本的 配置文档 为准。最终验收记录应同时保存高度、轮次、区块 ID、签名投票权重和消息到达时间,避免把一次暂时升高误判为持续恢复。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

根据节点日志定位最终性停滞

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通