include_empty如何补全收款地址表？

很多“地址迁移少了几百条”的问题，根因不是备份损坏，而是旧脚本用listreceivedbyaddress默认参数导出：从未收到付款的地址没有出现在结果里。include_empty专门决定是否补出这些零收款行，但全量地址表还需要确认描述符范围、标签和钱包扫描状态。

默认结果只关心出现过收款的地址

listreceivedbyaddress按收款地址列出余额，minconf默认1。

include_empty默认false；设为true才包含从未收到付款的地址。

minconf默认1，意味着未达到最低确认数的付款不会计入。include_empty默认false，意味着没有符合条件付款的地址被省略。两者叠加后，“不在结果中”可能是从未收款，也可能是收款尚未达到minconf，不能直接解释为地址不属于钱包。

目标	建议设置	还要核对
日常已确认收款表	minconf按业务阈值，include_empty=false	钱包扫描高度
地址全量清点	include_empty=true	描述符与keypool范围
单地址复核	address_filter指定地址	地址属于当前钱包
矿工报表	明确include_immature_coinbase	成熟高度与钱包角色

钱包能展示哪些地址取决于已生成地址、描述符范围、导入记录和钱包状态。开启include_empty只是把当前钱包视图中没有收款的地址纳入，不会凭空推导所有未来地址。迁移前应把listdescriptors、keypool状态和标签清单一起保存。

若钱包正在重扫，先等待扫描完成并记录lastprocessedblock。两个钱包即使使用同一组描述符，导入range或时间戳不同，也可能在某一时点得到不同清单。

address_filter可限制为一个非空地址，include_immature_coinbase默认false。

返回的confirmations是已纳入结果中最近交易的确认数，amount是该地址累计收到的总额，并附label与txids。

返回行包含地址、累计收到的amount、最近一笔被纳入交易的confirmations、label和txids。confirmations不是所有收款的平均值，也不是地址“年龄”；amount不会因后来把币花掉而自动变成当前剩余。

当前未花费输出应另用listunspent按地址和确认数重建，钱包级可用额则结合getbalances及业务冻结规则。一个地址累计收到10 BTC、当前UTXO为1 BTC完全可能，不能据此报警数据损坏。

第一张是地址目录：address、label、purpose、是否零收款、导出钱包与时间；第二张是收款事实：amount、最近确认数、txids与minconf。把参数写进报表元数据，避免下个月换阈值后把差异误认为新增或丢失。

重复标签不一定是错误，因为一个标签可包含多个收款地址；相同地址出现在两个互斥业务主体中才需要调查。对账脚本以地址为稳定键，标签为可变元数据，不能只靠标签名做join。

先比较两次导出的节点、钱包、版本和区块高度；再比较minconf与include_empty；随后检查描述符范围和扫描；最后用txids、listunspent和单地址查询定位差异。不要通过手工补行让总数对上，这会抹掉真实原因。

钱包汇总见getbalances余额口径，当前输出见listunspent筛UTXO，描述符清单见listdescriptors审计。本文提供数据口径，不证明地址背后的现实身份，也不构成资产可支配或会计确认意见。

资料访问时间为2026-08-13。仍需保留的边界：该接口不是当前可花余额报表，地址生成策略和描述符范围会影响include_empty清单。