# Wasabi 余额不对怎么查？检查同步、Resync 与地址扫描范围

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/wasabi-balance-sync-rescan
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

用已有交易和收款地址区分连接故障、离线未确认遗漏和 gap limit，优先使用 Resync Wallet，不靠重建钱包猜余额。

## 使用工具
- [Wasabi Wallet](https://lianxiaozhi.com/tools/wasabi-wallet) · [官方入口](https://docs.wasabiwallet.io/)

## 前置条件
- 已有可打开的官方 Wasabi 桌面钱包，准备一笔已知交易哈希、完整收款地址、应收 BTC 数量和原账户记录；排查无需重新输入助记词。
- 适用 Bitcoin 主网已有钱包。GUI Resync Wallet 要求2.5.0及之后；gap limit 文件编辑属于高级选项，不适用于网页钱包或其他币。
- 同步与重扫不广播付款或支付矿工费，但占用网络、时间；本地文件含敏感钱包数据，只由持有人保管。

## 1. 先定位钱包与一笔已知收款

从左侧 Wallets 选对应已有钱包，核对钱包名和原账户，再用已知哈希、完整收款地址、BTC 数量对照历史。先记录缺的是整段历史、某个地址，还是一笔 Pending；如果原交易发往另一个钱包地址，停止扫描排查，回到发送记录确认目标，不能把同金额当同一付款。

核对结果：得到确定的钱包和遗漏交易/地址清单，不因空余额认定资产消失。
依据：[Wasabi：钱包加载与 P2P 区块过滤器](https://docs.wasabiwallet.io/using-wasabi/WalletLoad.html)
依据：[Wasabi FAQ：同步、Resync、gap limit 与收款类型](https://docs.wasabiwallet.io/FAQ/FAQ-UseWasabi.html)

## 2. 区分已连接和同步已完成

看右下角 Tor 与 peers 状态，警告三角出现时悬停读取具体信息；等钱包加载计时结束，再核对历史。连接勾只说明连接就绪，过滤器和相关块尚未下载完时不能定案。当前 Wallet Load 描述从 P2P 节点请求过滤器，不能把配置 CoinJoin 协调者当成所有余额同步的前置。

核对结果：连接警告已解释，加载进度已完成或保留仍在加载的具体状态。
依据：[Wasabi：钱包加载与 P2P 区块过滤器](https://docs.wasabiwallet.io/using-wasabi/WalletLoad.html)
依据：[Wasabi FAQ：同步、Resync、gap limit 与收款类型](https://docs.wasabiwallet.io/FAQ/FAQ-UseWasabi.html)

## 3. 核对已有全节点的状态与回退

若原本启用了 Connect to Bitcoin Node RPC，查看状态栏 Bitcoin RPC 及警告信息，与自有节点运行状态对照。节点连不上时先记录错误，由节点持有人处理地址、权限和日志；此处不用重新输入或公开 RPC 凭据。Wasabi 可以回退获取数据，因此 RPC 警告与整个钱包完全无法同步不是同一结论。

核对结果：明确钱包是否使用已有节点、节点错误是什么、钱包总体是否仍在同步。
依据：[Wasabi：已有 Bitcoin 节点与连接状态](https://docs.wasabiwallet.io/using-wasabi/BitcoinFullNode.html)
依据：[Wasabi：钱包加载与 P2P 区块过滤器](https://docs.wasabiwallet.io/using-wasabi/WalletLoad.html)

## 4. 确认遗漏确属历史后重新扫描

同步结束仍漏已确认交易时，进入 Wallet Settings→Tools→Resync Wallet，按当前界面启动重扫并等待加载结束。先确保钱包没有正在进行的 CoinJoin；若处于橙色关键阶段，不关闭应用或编辑文件，等该阶段结束再处理。重扫耗时变化不代表支付失败，重扫后重新对照原哈希和地址。

核对结果：重扫完成后按原清单复查；没有把重扫按钮视为转账、退款或自动修复证明。
依据：[Wasabi FAQ：同步、Resync、gap limit 与收款类型](https://docs.wasabiwallet.io/FAQ/FAQ-UseWasabi.html)
依据：[Wasabi：CoinJoin 当前前置、默认状态及费用条件](https://docs.wasabiwallet.io/using-wasabi/CoinJoin.html)

## 5. 仍有遗漏时按地址范围处理 gap limit

有连续生成大量未使用地址等具体线索时，在搜索栏输入 Wallet Folder 找到对应文件。先保存受保护副本，再在无活动 CoinJoin 的情况下关闭 Wasabi。持有人仅调整该钱包 JSON 的 MinGapLimit 到能覆盖实际使用范围的值，必要时将 BlockchainState.Height 设为0，保存后重启等待重扫。文件默认21与助记词恢复高级选项默认100不同，不能把100当所有账户必然足够；解析错误时用副本恢复，勿上传整个 JSON。

核对结果：修改的是已核对钱包的监测范围；文件可加载，重扫完成且已知远端地址重新检查。
依据：[Wasabi FAQ：同步、Resync、gap limit 与收款类型](https://docs.wasabiwallet.io/FAQ/FAQ-UseWasabi.html)
依据：[Wasabi：CoinJoin 当前前置、默认状态及费用条件](https://docs.wasabiwallet.io/using-wasabi/CoinJoin.html)

## 6. 将未确认遗漏与余额结果分别记录

如果付款广播时 Wasabi 离线，可能没接到未确认传播，要向发送方取原哈希并保留 Pending 状态，等首次区块确认后再检查钱包。不要因当前看不见而重复付款。记录检查时间、钱包版本、同步状态、已找到及仍未找到的哈希；地址或账户范围仍无法确认时保留未知，交由持有人继续排查。

核对结果：有可复核结果及未解决原因；只有看到相应确认记录才标为已确认。
依据：[Wasabi：Receive、标签与未确认收款](https://docs.wasabiwallet.io/using-wasabi/Receive.html)
依据：[Wasabi FAQ：同步、Resync、gap limit 与收款类型](https://docs.wasabiwallet.io/FAQ/FAQ-UseWasabi.html)

## 常见错误
- 文件编辑不能创造余额；钱包、网络、派生账户或 passphrase 不同，需要先找原配置，不用新的恢复尝试覆盖旧文件。
- gap limit 是连续未使用地址的扫描边界；重复重扫同一范围不能保证找到范围外的地址。
- 重新扫描不需要启动 CoinJoin。协调者可用性和隐私评分不作为本教程余额验收条件。

## 完成检查
- 记录了对应钱包、原交易/地址、同步和节点状态，已知遗漏得到解释或列出仍待核的具体输入。
- 需要时完成 GUI 重扫或持有人按范围重扫，按已确认交易复查；离线未确认单独保留状态。
- 官方文档核验范围；未实际操作钱包、修改钱包文件、输入秘密或验收余额恢复。

## 相关知识
- [比特币 UTXO 与找零：为什么转一笔账会出现多个输出](https://lianxiaozhi.com/learn/utxo-and-change)
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)

## 官方依据
- [Wasabi：钱包加载与 P2P 区块过滤器](https://docs.wasabiwallet.io/using-wasabi/WalletLoad.html)
- [Wasabi FAQ：同步、Resync、gap limit 与收款类型](https://docs.wasabiwallet.io/FAQ/FAQ-UseWasabi.html)
- [Wasabi：已有 Bitcoin 节点与连接状态](https://docs.wasabiwallet.io/using-wasabi/BitcoinFullNode.html)
- [Wasabi：Receive、标签与未确认收款](https://docs.wasabiwallet.io/using-wasabi/Receive.html)
- [Wasabi：CoinJoin 当前前置、默认状态及费用条件](https://docs.wasabiwallet.io/using-wasabi/CoinJoin.html)
