节点的日志开关怎么用：logging 命令与 debug 分类的现场取证

一、日志的两层配置

比特币核心的日志有两层控制面：启动参数 -debug 与 -debugexclude 定出厂默认，运行中的 logging 命令负责临时开合各路灯。配置文件管的是节点出生时的性格，RPC 管的是当下这一场问诊。

二、logging 的参数形状

不带参数调用 logging，返回一张全景表：键是类别名，值是亮灭。开灯把类别放进第一个数组，比如 bitcoin-cli logging '["net"]'；关灯走第二个数组，文档示例的写法是 bitcoin-cli logging '["all"]' '["http"]'——前者把能开的都点亮，后者顺手把 http 类关掉。一次可以放多个类别，返回表会列出受影响的每一类。单独设置类别与另一组控制参数不能混在同一次调用里，混写会被拒。

三、类别地图

net 管连接与对端通信，peer 管单条连接的细节，mempool 管交易进池出池的裁决，tx 跟单笔交易的一生，validation 记区块验收的判决，rpc 记录每个外来调用，wallet 管钱包侧的分寸，http 是 RPC 服务的 HTTP 层。排障先猜嫌疑人再点灯：连接反复掉线开 net 与 peer；交易广播无回音开 tx 与 mempool；同步卡在某个块开 validation。一次开太多类别，日志洪水会把关键三行冲走，用完记得关灯是纪律。

类别名可以从全景表里直接挑：不带参数调用一次，返回的键清单就是当前版本支持的全部类别，新旧版本之间的增删以这张表为准，不用背。all 是兜底键，把每一盏灯都点亮；对应地，把 all 放进排除数组就整体静音，只留你单独点名的那几类。

四、开关状态存在哪

logging 的改动活在当前进程里：重启节点，一切回到启动参数定的初始配置。想把临时调试变成长期行为，改的是配置文件里的 -debug 系列。命令本身不提供”当前配置来自哪些启动参数”的回查，排查配置歧义要回到 debug.log 开头打印的生效参数。

五、取证三步

第一步定位问题发生的时刻区间，用 uptime 与日志时间戳对齐；第二步对嫌疑类别开灯，静候复现；第三步看完立刻关灯——类别名放进第二个数组即可。日志量随类别组合爆炸，长时间挂着全量 debug 的节点，磁盘与噪声都遭不住；新版本还对日志写入做了配额式节流，超配额直接跳过输出，长期 debug 前先读当前版本的说明。

开灯之前先想好灯照哪里。日志文件本身落在数据目录里，文件名固定为 debug.log，节点运行中的每一次类别开关也会在日志里留下痕迹——求助帖里贴日志时，这段开关史是宝贵的现场证据：什么时间点、开了哪几类、随后发生了什么，因果链一目了然。反过来，如果日志里出现自己没开过的类别在刷屏，先怀疑有自动化脚本或监控代理在调用 logging 接口，顺着 rpc 类日志找出调用方再处置。

六、隐私边界

日志记录的不只是流水。交易与地址会随 tx、mempool 类别落盘，对端地址与连接特征随 net、peer 落盘。求助发帖或云端备份前，把日志里的地址、交易 ID 和真实 IP 做脱敏处理。日志不记录私钥，但不等于不含隐私。钱包类日志尤其敏感：地址标注、找零行为、选币偏好在 wallet 类下一应俱全，贴日志等于公开半个账本，删减时别只删钱包名留着交易明细。

七、和 RPC 日志的联动

排查”某个调用为什么卡”时，rpc 类日志与 getrpcinfo 是一对：前者记下每个调用的来龙去脉，后者列出此刻正在跑的请求与起始时间。两边一对时区，长请求是谁发起的、跑了多久，一目了然。

风险提示：本文仅为技术机制科普，不构成任何投资建议。