avoid_reuse开启后余额为何变了？

开启avoid_reuse后，钱包界面或业务余额可能与之前不同。第一反应不应是“币丢了”，也不应是立刻关闭标志，而要先确认哪些输出因地址重用被标成used或reused、业务的选币与余额调用怎样处理它们。这个开关增加的是隐私风险视图，不会改写链上交易。

setwalletflag修改的是钱包状态

Bitcoin Core 31.0的setwalletflag用于修改钱包标志，当前可用标志为avoid_reuse，value默认true。

调用对象是当前加载的钱包。生产环境若同时加载多个钱包，应在记录里写清钱包名和RPC路由，避免在错误钱包执行。参数value默认true，因此运维脚本不要省略布尔值；显式参数更便于审计和复跑。

开启前保存getwalletinfo、getbalances和listunspent的原始JSON，以及lastprocessedblock、节点链尖、钱包扫描状态和版本。没有同一高度的前后样本，余额变化很难归因。

getwalletinfo的avoid_reuse表示钱包是否按地址重用跟踪clean/dirty coins，flags也会列出当前钱包标志。

avoid_reuse开启后，getbalances可能出现mine.used，代表发送到已从中花费过的地址之币。

listunspent在avoid_reuse开启时可返回reused字段，逐UTXO标识地址重用相关输出。

字段	层级	含义
avoid_reuse	钱包级	是否跟踪地址重用相关clean/dirty coins
mine.used	汇总余额级	发送到曾从中花费过的地址之币
reused	单个UTXO级	该输出是否与已重用地址相关

这三者不能互相替代。getwalletinfo只说明能力是否开启；getbalances帮助观察汇总影响；listunspent用于定位具体outpoint。若只记录一个总余额，就无法解释哪些输出发生分类变化。

地址一旦从中花费过，又收到新的输出，链上观察者更容易把前后活动关联。avoid_reuse用钱包历史帮助识别这类输出，目的是减少后续选币继续扩大关联。这里的dirty不是法律上的“赃币”，也不表示该UTXO在协议层无效。

因此，对外沟通不要使用“黑币”“冻结”或“消失”等未经事实支持的词。正确描述是：钱包启用了地址重用跟踪，某些输出被分类为used/reused，当前业务可用额是否排除它们取决于调用和选币策略。

提现服务、会计看板、余额告警和自动归集可能只读取一个旧接口字段。先在只读副本或维护窗口演练，确认解析器允许新增used字段，报表不会把它重复相加，选币失败时能返回明确原因。

小额测试应覆盖新地址收款、已使用地址再次收款、正常发送和余额读取。每步保存交易、UTXO和字段变化。不要为了制造测试样本在主钱包刻意复用高价值地址。

先确认钱包视图高度和扫描状态一致；再比较used汇总；然后用listunspent定位reused输出；最后检查业务调用是否默认排除这些币。链上浏览器看到输出仍未花费，只能证明协议状态，不能自动解释Bitcoin Core钱包的隐私选币策略。

需要动用被标记输出时，先评估隐私影响和业务必要性。不要把多个身份或客户UTXO合并来“清理标签”，这可能强化链上聚类。高价值钱包应由熟悉Bitcoin Core版本和内部风控的人审批变更。

余额桶解释见getbalances余额桶，逐UTXO筛选见listunspent安全UTXO，避免地址重用的另一种设计见静默支付防地址复用。本文是钱包运维指南，不构成链上隐私保证、法律标签或资产处置建议。

资料访问时间为2026-08-13。仍需保留的边界：开启后的选币与可用余额表现依赖钱包历史和后续调用参数，生产钱包应先在备份与维护窗口演练。