getblockchaininfo怎样判断同步？

blocks追上headers是常见健康条件，却不是充分条件。节点可能连接在错误网络、仍处于initial block download、验证进度估计尚低、出现链状态警告，或因修剪无法满足历史查询。getblockchaininfo要按“链身份、同步、链质量、存储边界”四组字段读。

先确认chain和bestblockhash

getblockchaininfo返回当前处理链、blocks、headers、bestblockhash、difficulty与chainwork等状态。

chain区分main、test、signet或regtest等网络。自动化如果不校验chain，测试网节点也可能因为blocks等于headers而显示绿色。bestblockhash用于把本次快照与其它节点对齐，difficulty和chainwork则提供链状态旁证。

监控采样保存节点标识、版本和时间。负载均衡后的RPC可能每次命中不同后端，看到高度来回跳动；要么固定后端，要么在指标标签中保留实例。

verificationprogress是验证进度估计，initialblockdownload指示节点是否处于初始区块下载。

常规就绪规则可以要求chain正确、IBD为false、blocks接近可信参考、headers与blocks差距可接受，并且warnings为空或已被解释。不要只用verificationprogress等于1；浮点估计和显示舍入会制造脆弱规则。

如果节点P2P连接异常，它知道的headers本身就可能陈旧。将本节点bestblockhash或高度与多个可信节点比较，同时监控getnetworkinfo的connections和网络活跃状态。外部参考也要避免单点，特别是在链重组或网络分区期间。

高度差告警应结合持续时间和目标业务。只需最新区块的服务与需要低延迟广播的服务容忍度不同；短暂一两个区块落后不必自动重启。

pruned指示节点是否启用修剪；启用时还会返回pruneheight、automatic_pruning和prune_target_size。

pruned为true时，节点主动删除旧区块文件以控制磁盘。pruneheight表明本地保留历史的边界信息，automatic_pruning和prune_target_size解释修剪策略。同步完成与历史完整是两件事：修剪节点可以完全同步，却无法提供所有旧区块正文。

因此备份、钱包重扫、索引器和审计任务要分别检查所需历史范围。不能因为IBD为false就宣称节点是archive。变更修剪策略前确认磁盘、重新下载成本和下游依赖。

warnings字段用于报告网络或链状态警告，监控不能只比较blocks与headers。

warnings用于报告链或网络相关警告。监控应保留原文、首次出现时间和版本，避免只按是否为空做无上下文告警。升级期间字段格式可能变化，解析器应容忍新增内容而不是整个指标采集失败。

同时使用getchaintips观察分叉尖端，有助于解释reorg或无效分支；但出现多个tip不自动等于受攻击，要结合状态、分支长度和日志。

启动期先校验chain；等待IBD退出；确认blocks与多个参考链头差距在阈值内；确认连接性；检查warnings；最后验证业务所需的prune和索引能力。每项失败输出具体字段，不把所有情况压成HTTP 500。

索引状态见getindexinfo同步判断，修剪查询边界见裁剪节点历史数据，P2P旁证见getnetworkinfo节点连接。本文给出监控口径，不替代Bitcoin Core版本说明和业务恢复演练。

资料访问时间为2026-08-14。仍需保留的边界：verificationprogress是估计值，健康阈值需结合网络链头、时间与业务所需历史深度。