区块链原理 / 系统课时
用调试日志与 RPC 定位广播失败
用调试日志与 RPC 定位广播失败
节点 A 的 sendrawtransaction 返回了交易 ID,节点 B 却迟迟看不到交易,未必是 P2P 连接断开。排查时把“节点是否连通、交易是否被本地接纳、是否向邻居传播”分开取证,最后用接收端预检和日志锁定故障层。
学习目标
- 使用
getpeerinfo和getblockchaininfo排除断连、错网与尚未完成同步。 - 使用
getmempoolentry判断交易在节点 A、B 的本地接纳状态。 - 配合
logging、debug.log和testmempoolaccept区分未接纳、传播受限与接收端拒收。
固定排查对象与观察窗口
以下以 Bitcoin Core 30.0 的两个运行中 regtest 节点为例,节点 A、B 使用不同数据目录与 RPC/P2P 端口,且本机已安装 bitcoin-cli 和 jq。检查的是同一个未确认交易 txid,不要在诊断期间手动出块;一旦交易确认,内存池查询不到它就是正常现象。
确认两个节点都在 regtest,区块高度相近,initialblockdownload 为 false。RPC 端口用于控制节点,P2P 端口用于交易传播:RPC 能调用成功不代表两节点已经建立 P2P 连接。开始复现前记录交易 ID、操作时间和 A/B 的数据目录,避免把不同交易或旧日志混为一谈。
用 RPC 判断故障停在哪一层
把下面的路径改为实际的两个数据目录,将 <ID> 替换为 64 位十六进制交易 ID。-datadir 会让 CLI 使用相应节点的配置与 RPC cookie;示例假设这两个目录已按各自的 RPC 端口正确配置。
#!/usr/bin/env bash
set -euo pipefail
A_DIR="$HOME/bitcoin-lab/node-a"
B_DIR="$HOME/bitcoin-lab/node-b"
TXID="<ID>"
check_node() {
local label="$1" dir="$2"
echo "=== $label ==="
bitcoin-cli -regtest -datadir="$dir" getblockchaininfo |
jq -r '"CHAIN=\(.chain) HEIGHT=\(.blocks) IBD=\(.initialblockdownload)"'
bitcoin-cli -regtest -datadir="$dir" getpeerinfo |
jq -r 'if length == 0 then "PEERS=none" else .[] | "PEER=\(.addr) TYPE=\(.connection_type) RELAY=\(.relaytxes) MINFEE=\(.minfeefilter)" end'
# 失败只代表尚未证实在内存池,需再看 RPC 错误原因。
if bitcoin-cli -regtest -datadir="$dir" getmempoolentry "$TXID" >/dev/null 2>&1; then
echo "MEMPOOL=present"
else
echo "MEMPOOL=unknown_or_absent"
fi
}
check_node A "$A_DIR"
check_node B "$B_DIR"预期输出示例(高度、地址、端口及费率由实际环境决定):
=== A ===
CHAIN=regtest HEIGHT=<HEIGHT> IBD=false
PEER=127.0.0.1:<PORT> TYPE=manual RELAY=true MINFEE=<RATE>
MEMPOOL=present
=== B ===
CHAIN=regtest HEIGHT=<HEIGHT> IBD=false
PEER=127.0.0.1:<PORT> TYPE=inbound RELAY=true MINFEE=<RATE>
MEMPOOL=unknown_or_absent这是“A 已接纳、B 尚未查到”的一种情况,不足以断言 A 没有发送。若显示 PEERS=none 或缺少预期邻居,应检查 P2P 监听地址、端口、-connect/-addnode 设置与网络类型;若 RPC 本身失败,先修正节点进程、数据目录或凭证,再判断交易状态。
getpeerinfo 的 relaytxes 表示是否向该对等节点转发交易,connection_type=block-relay-only 表示连接不用于普通交易中继;minfeefilter 反映对端声明的最低交易费率(BTC/kvB)。last_transaction 与按消息类型统计的字节数可以辅助观察活动,但它们不能证明指定 txid已被转发。字段定义见 Bitcoin Core 30.0 getpeerinfo 文档。
用双端内存池证据缩小范围
按照 A、B 的连接及交易状态判定:
| 观察结果 | 优先排查点 |
|---|---|
| A 与 B 未连接 | 网络、P2P 端口、对端地址和连接限制 |
| A 无交易,B 无交易 | A 的签名、输入、费用或本地接纳策略 |
| A 有交易,B 无交易 | A 的中继设置、对端费率过滤,或 B 收到后拒收 |
| A 与 B 均有交易 | 已完成本地接纳与跨节点传播,不应再归因于广播失败 |

getmempoolentry 在交易不属于当前内存池时会报错;如果命令运行条件异常,也可能失败,所以脚本故意输出 unknown_or_absent,而不是武断地写“已拒收”。需要时直接执行原 RPC 查看错误消息,并先排除交易已入块、节点尚未同步或交易已被驱逐。
在问题重现前打开调试日志
对两个节点分别启用 net、mempool、mempoolrej 日志类别,再构造一笔新的测试交易并广播,随后读取对应节点 regtest/debug.log。旧事件不会因为后来开启日志而补写,重复提交已知交易也不保证重走完整传播链。
A_DIR="$HOME/bitcoin-lab/node-a"
B_DIR="$HOME/bitcoin-lab/node-b"
bitcoin-cli -regtest -datadir="$A_DIR" logging '["net","mempool","mempoolrej"]' |
jq '{net,mempool,mempoolrej}'
bitcoin-cli -regtest -datadir="$B_DIR" logging '["net","mempool","mempoolrej"]' |
jq '{net,mempool,mempoolrej}'
# 新交易广播后,分别查看节点日志的近期记录。
tail -n 200 "$A_DIR/regtest/debug.log" | grep -Ei 'inv|tx|mempool|reject' || true
tail -n 200 "$B_DIR/regtest/debug.log" | grep -Ei 'inv|tx|mempool|reject' || true预期输出:以下为每次 logging 调用的结果示例;tail 和 grep 后续显示的具体日志行随事件而变化,也可能没有匹配行。
{
"net": true,
"mempool": true,
"mempoolrej": true
}核查日志时间、节点身份、对应 txid 或 wtxid 及拒收理由,不能仅凭一条 inv 日志就断定交易已被 B 接纳。
从 B 的策略结果确认根因
当 A 的内存池中确实有目标交易、B 没有,且两节点仍处于相同测试链时,可从 A 取出原始交易,在 B 上执行不实际加入内存池的预检:
A_DIR="$HOME/bitcoin-lab/node-a"
B_DIR="$HOME/bitcoin-lab/node-b"
TXID="<ID>"
# 仅在 A 仍持有这笔未确认交易时读取原始字节。
RAW_TX=$(bitcoin-cli -regtest -datadir="$A_DIR" getrawtransaction "$TXID")
bitcoin-cli -regtest -datadir="$B_DIR" testmempoolaccept "[\"$RAW_TX\"]" |
jq -r '.[0] | if .allowed == true then "PRECHECK=allowed" else "PRECHECK=rejected: " + (.["reject-reason"] // "unknown") end'预期输出(B 当前允许接纳的情况):
PRECHECK=allowed不满足策略时输出 PRECHECK=rejected: <REASON>,其中 <REASON> 为节点实际返回的原因。allowed=true 只证明此刻 B 的预检可通过,不证明 B 先前收到了广播;allowed=false 则应结合 reject-reason、B 的内存池费率门槛、输入是否已花费和是否缺失父交易继续处理。
例如 A 有交易、B 无交易,B 预检返回允许,应优先检查 A 的 relaytxes、连接类型、对端 minfeefilter 和日志中的实际网络活动;若 B 预检拒收,则先修复费用、依赖或冲突等具体问题。排障完成后可关闭临时开启的日志类别,避免 net 日志持续增长;testmempoolaccept 的字段以 Bitcoin Core 30.0 RPC 文档 为准。