区块链原理 / 系统课时

用 JSON-RPC 检查区块与连接状态

用 JSON-RPC 检查区块与连接状态

只看到 bitcoind 进程运行,不能说明它连接了正确网络或已经处理区块。这里在本地 regtest 节点上分别读取链状态与 P2P 状态,再用原始 JSON-RPC 请求交叉验证,最终得到可复核的检查结果。

学习目标

  • 使用 getblockchaininfo 确认链类型、区块高度与同步信号。
  • 使用 getnetworkinfo 和 getconnectioncount 区分 P2P 开关与实际连接数。
  • 识别 RPC 不可达、网络选错和节点无对等连接三种现象。

准备独立的 regtest 节点

下面以 Bitcoin Core 30.0、Linux/macOS 终端为例,要求 bitcoind、bitcoin-cli 已安装并在 PATH 中。regtest 是本地回归测试网络,不会自动连接比特币主网。若已启动相同数据目录的节点,跳过启动命令。

bash
bitcoind -regtest -daemon

预期输出:

text
Bitcoin Core starting

等待 RPC 可用并读取高度:

bash
bitcoin-cli -regtest -rpcwait getblockcount

预期输出(全新、尚未挖矿的 regtest 目录):

text
0

-regtest 也必须传给 bitcoin-cli,使它选择相同网络对应的 RPC 端口与身份凭据;regtest 默认 RPC 端口是 18443。如果使用了 -datadir,客户端也需要指定相同的数据目录。已有区块时高度可能大于 0。

核对链类型、区块高度与同步状态

bash
bitcoin-cli -regtest getblockchaininfo

预期输出(全新 regtest 节点的关键字段节选,其他字段未展示):

json
{
  "chain": "regtest",
  "blocks": 0,
  "headers": 0
}

chain 用来排除误连主网,blocks 是已完整验证的活动链高度,headers 是已验证的区块头高度,创世块高度为 0。若出现 headers > blocks,说明区块处理尚未追上已知区块头,不能按“已同步”处理。

同时查看返回对象的 initialblockdownload 和 verificationprogress:前者是初始区块下载状态的估计,后者是校验进度估计。它们是辅助信号;尤其在没有外部对等节点的 regtest 上,blocks == headers 并不能证明网络已同步到其他节点。字段定义可核对 Bitcoin Core 30.0 的 RPC 文档。

检查 P2P 开关和实际连接数

bash
bitcoin-cli -regtest getnetworkinfo

预期输出(单节点、未手动添加对等节点时的字段节选):

json
{
  "networkactive": true,
  "connections": 0,
  "connections_in": 0,
  "connections_out": 0
}

networkactive=true 仅表示启用了 P2P 网络功能,不能证明已经连上其他节点。connections 是当前连接总数,connections_in 与 connections_out 分别对应入站和出站。单节点 regtest 的 connections=0 是正常现象;如果在需要同步其他节点的环境中长期为 0,才应检查对等节点配置、可达性及网络设置。

使用专门接口复核连接总数:

bash
bitcoin-cli -regtest getconnectioncount

预期输出(隔离的单节点 regtest):

text
0

它应当与 getnetworkinfo.connections 对应;两次 RPC 并非原子快照,连接在期间变化时计数可能略有不同。

用原始 HTTP 请求确认 JSON-RPC 协议

bitcoin-cli 已经封装了认证和请求格式。要检查真正的 JSON-RPC 交互,可在默认 Linux 数据目录上使用 curl,从 regtest 的 .cookie 文件取得临时本地认证信息;此示例不把密码直接写进命令。

bash
curl -sS -w '\nHTTP %{http_code}\n' \
  --user "$(cat "$HOME/.bitcoin/regtest/.cookie")" \
  -H 'Content-Type: application/json' \
  --data-binary '{"jsonrpc":"2.0","id":"peer-check","method":"getconnectioncount","params":[]}' \
  http://127.0.0.1:18443/

预期输出(隔离的单节点 regtest,空格及字段排列可能不同):

text
{"jsonrpc":"2.0","result":0,"id":"peer-check"}
HTTP 200

method 是 RPC 方法名,params 是参数数组,id 用于对应请求与响应;返回的 result=0 是节点给出的连接数。该请求使用 JSON-RPC 2.0,成功响应包含 result 而不包含 error。出现 HTTP 401 通常意味着 cookie 路径或身份凭据有误。不可把 RPC 服务直接暴露到互联网,也不要公开 .cookie 内容。

按症状定位失败

现象 先检查 判定与修正
Could not connect to the server bitcoind 是否启动,-regtest、-datadir 是否一致 先确认 RPC 服务已就绪;regtest 默认走 18443,不是主网 8332
Authorization failed 或 HTTP 401 .cookie 文件位置、进程所属用户、RPC 配置 用节点对应的 cookie 或正确认证方式重试,不要将凭据写入公开脚本
chain 不是 regtest 启动和客户端的网络参数 明确在两端指定 -regtest,避免跨网络误诊
connections=0 是否本来就是单节点,networkactive 是否为 true 单节点 regtest 无需修复;多节点环境再检查连接地址与防火墙

验收时记录 chain、blocks、headers、initialblockdownload、networkactive 和 connections 六项即可复核本次检测。检查时间不同,区块高度与连接数可能变化,因此不要把一次返回当成永久状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 JSON-RPC 检查区块与连接状态

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

登录哪都通