节点视角的分叉地图：getchaintips 五种状态怎么读

一、全节点手里有一张森林，不是一条线

共识规则告诉节点永远选累计工作量最大的链，但工作没有丢：传播慢了一步的块、只在少数对端之间流通的块、验证到一半发现问题的块，都会以分支的形式留在数据库里。getchaintips 就是这张森林的鸟瞰图，每个条目给出一条链的顶端哈希、分支长度和状态。

二、五种状态逐一说清

文档列出的状态共五种。active 只有一条：当前活动主链的顶点，确定有效。valid-fork 表示这条分支不属于活动链，但区块全部拿齐且完整验证过——网络平局时刻被工作量战胜的那一支常在这里安家，它是重组真实发生过最直观的证物。valid-headers 是所有区块都已取得、但从未做完整验证的分支，节点只在需要时才补验。headers-only 更浅一层：块头链有效、区块体还没下载齐。invalid 则意味着分支里至少有一个区块被判定无效，整条链连带失去资格。

三、branchlen 量的是分岔远近

branchlen 记录这条分支接到主链之前有多长，主链自身为零。它和高度、状态合起来可以还原一次重组的形貌：某个历史时点上，有一条 branchlen 为 2 的 valid-fork 分支，说明节点当时曾短暂站在离主链两步远的另一侧。重组监测、矿池掉线影响分析这类问题，答案常常就藏在这些分支的长度与状态组合里。

四、invalid 是怎么来的

分支被判 invalid 主要有两种来历：一是节点自己验证到某个区块违反共识规则，二是运维人员用 RPC 把特定区块标记为无效，让它连同后续区块退出候选。前者的出现意味着版本缺陷或数据损坏，应当立刻检查软件版本与日志；后者是一种手动排障手段，误操作的后果是自己掉出网络，恢复手段是把区块重新标记有效。用 invalid 状态做重组排查时要注意：只要分支上挂着 invalid，不管其余区块多健康，这个提示的含义仅仅是别信这条链。

五、日常怎么用

普通运维里三个用法最常见：升级节点后对比 getchaintips，确认没有意外分支滞留；监控脚本把 valid-fork 数量与出现频率当作网络传播质量的仪表；排查同步缓慢时看 headers-only 分支堆积，往往指向区块下载而不是链本身的问题。地图本身不改写任何链状态，它只把节点的记忆摊给你看。

本文是节点工具科普，不构成投资建议。

六、几个容易误读的细节

第一，条目数量与节点历史成正比。一台跑了很多年、经历过多轮分叉与重组的节点，地图上的分支会比刚同步完的节点多得多，这不代表它更不稳定，只代表它记得更多。第二，headers-only 与 valid-headers 的区别只在区块体到位没有，两者都不代表分叉正在发生，多数时候它们只是块头下载领先于区块下载的常态。第三，同一条分叉上往往只列出顶端，branchlen 告诉你的是这条分支从主链分出去之后自己长了多少个块，理解这一点就不会把分叉深度与高度差混为一谈。把这些细节放进日常观察，getchaintips 就从一次性的查询变成一台记录链史的黑匣子。

七、与相邻工具搭成一条排障流水线

单看这张地图常常不够，它的价值在组合里。第一步用 getblockchaininfo 确认当前活动链的高度与进度，第二步 getchaintips 看有没有额外分支以及它们的深浅，第三步对可疑分支用 getblock 逐块核对时间戳、版本与大小是否异常。如果 invalid 分支指向你确信合法的区块，问题多半出在本机版本或数据完整性，回到版本与日志找答案；如果分支只是历史遗留的 valid-fork，安心让它躺在地图上即可。三个命令轮转一遍，绝大多数链状态类疑问都能在几分钟内定性，这比在论坛贴一句我的节点正常吗有效得多。