# Bitcoin Core 恢复后余额为零：先区分链同步、钱包扫描和余额状态

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

核对已有节点与钱包状态，定位选错钱包、未完成扫描或余额口径问题，保留裁剪历史和旧版迁移限制。

## 使用工具
- [Bitcoin Core](https://lianxiaozhi.com/tools/bitcoin-core) · [官方入口](https://bitcoincore.org/)

## 前置条件
- 准备本人已安装版本、原钱包公开身份及既有去敏状态记录；没有这些记录的项目标为待取得，不在本站输入备份文件、密码或RPC凭据。
- 本文依据31.0版RPC字段和核验日31.1下载信息；不是启动节点、导入备份或执行迁移的操作教程。

## 1. 先确认版本与原钱包身份

查看已安装版本和原钱包名称、公开地址记录；恢复后检查已有 restorewallet 结果中的 name 与 warnings。返回新名称或启动加载设置成功，并不证明原地址、历史交易和密钥已经齐全。30.0/30.1 的特定迁移缺陷已有30.2修复，不以旧版命令试验；先保存原备份与错误记录。

核对结果：明确软件版本、目标钱包及恢复警告，没有将新建空钱包当作原钱包。
依据：[Bitcoin Core 31.0 RPC：恢复加载及警告](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/restorewallet/)
依据：[Bitcoin Core：30.0/30.1 钱包迁移缺陷公告](https://bitcoincore.org/en/2026/01/05/wallet-migration-bug/)
依据：[Bitcoin Core 30.2：钱包迁移修复发布说明](https://bitcoincore.org/en/releases/30.2/)
依据：[Bitcoin Core 31.1：当前版本发布说明](https://bitcoincore.org/en/releases/31.1/)

## 2. 确认节点正在处理哪条链

在已有 getblockchaininfo 记录中看 chain、blocks、headers 和记录时间。Bitcoin主网应为 main；headers 是已验证区块头数量，blocks 才是完全验证链高度。initialblockdownload 与 verificationprogress 是估计，不能以单个接近100%的值证明交易到账。

核对结果：网络与时间一致，区块头进度、区块验证进度和交易确认分别记录。
依据：[Bitcoin Core 31.0 RPC：链同步与裁剪范围](https://bitcoincore.org/en/doc/31.0.0/rpc/blockchain/getblockchaininfo/)

## 3. 核对选中的钱包与扫描状态

在同一钱包已有 getwalletinfo 响应看 walletname、blank、private_keys_enabled 和 external_signer，确认选中的不是新建空钱包或另一账户。scanning 可能为进度对象或 false；false 只说明当时没有扫描，不能证明恢复覆盖了原钱包全部历史。

核对结果：钱包身份和能力明确，扫描中、未扫描及未知覆盖范围没有混为一项。
依据：[Bitcoin Core 31.0 RPC：钱包名称、扫描与处理高度](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/getwalletinfo/)

## 4. 比较钱包处理高度并检查裁剪

比较钱包 lastprocessedblock 与同期节点 blocks，保留高度、哈希和时间；不同时间记录的差距不能直接诊断故障。节点 pruned 为 true 时检查 pruneheight，之前区块已裁剪。本地 rescan 只扫描本地链记录，缺少的早期范围保持待核，不能重复扫一次就称为完整恢复。

核对结果：分别列出节点高度、钱包处理高度、扫描范围及本地缺失区间。
依据：[Bitcoin Core 31.0 RPC：钱包名称、扫描与处理高度](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/getwalletinfo/)
依据：[Bitcoin Core 31.0 RPC：链同步与裁剪范围](https://bitcoincore.org/en/doc/31.0.0/rpc/blockchain/getblockchaininfo/)
依据：[Bitcoin Core 31.0 RPC：本地区块扫描范围](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/rescanblockchain/)

## 5. 按余额类别理解零值和待确认

已有 getbalances 结果以 BTC 为单位：mine 对应钱包可签的输出；trusted 也包含钱包自行创建的输出，因此不能一概当作已确认；untrusted_pending 和 immature 分别代表特定待确认输出与未成熟挖矿奖励。字段缺失或错误响应保持未知，不填零；这份余额结构也不能独立证明外部签名钱包的全部可支配资金。

核对结果：记录原始单位、类别与处理高度；没有把可信状态当确认数，缺数据没有记成资产归零。
依据：[Bitcoin Core 31.0 RPC：余额单位与状态](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/getbalances/)
依据：[Bitcoin Core 31.0 RPC：钱包名称、扫描与处理高度](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/getwalletinfo/)

## 6. 整理下一步需要的记录

输出所用版本、目标网络和钱包、恢复警告、节点与钱包高度、扫描起止范围以及分项余额。若扫描仍进行，观察同一钱包后续进度；若身份、历史范围或备份材料缺失，先解决相应缺口。不通过迁移、覆盖原文件、导出私钥或发送新交易验证恢复。

核对结果：能把问题定位到版本、钱包选择、链同步、钱包扫描或余额口径；仍缺证据的部分明确待核。
依据：[Bitcoin Core 31.0 RPC：钱包名称、扫描与处理高度](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/getwalletinfo/)
依据：[Bitcoin Core 31.0 RPC：本地区块扫描范围](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/rescanblockchain/)
依据：[Bitcoin Core 31.0 RPC：恢复加载及警告](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/restorewallet/)
依据：[Bitcoin Core：30.0/30.1 钱包迁移缺陷公告](https://bitcoincore.org/en/2026/01/05/wallet-migration-bug/)

## 常见错误
- 用节点已同步或 scanning=false 推断钱包资产已完整恢复。
- 把 trusted 等同于链上确认，把缺失响应解释成真实零余额。
- 将历史30.0/30.1迁移示例当作当前无版本限制的恢复办法。

## 完成检查
- 能够列出钱包身份、网络、节点/钱包处理高度、扫描区间和分项余额，并明确仍缺的恢复证据。
- 仅阅读官方文档及解释既有记录；未启动节点、恢复备份、操作账户、导出密钥、签名或广播。

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

## 官方依据
- [Bitcoin Core：下载、校验与资源要求](https://bitcoincore.org/en/download/)
- [Bitcoin Core 31.0 RPC：钱包名称、扫描与处理高度](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/getwalletinfo/)
- [Bitcoin Core 31.0 RPC：链同步与裁剪范围](https://bitcoincore.org/en/doc/31.0.0/rpc/blockchain/getblockchaininfo/)
- [Bitcoin Core 31.0 RPC：余额单位与状态](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/getbalances/)
- [Bitcoin Core 31.0 RPC：恢复加载及警告](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/restorewallet/)
- [Bitcoin Core 31.0 RPC：本地区块扫描范围](https://bitcoincore.org/en/doc/31.0.0/rpc/wallet/rescanblockchain/)
- [Bitcoin Core：30.0/30.1 钱包迁移缺陷公告](https://bitcoincore.org/en/2026/01/05/wallet-migration-bug/)
- [Bitcoin Core 30.2：钱包迁移修复发布说明](https://bitcoincore.org/en/releases/30.2/)
- [Bitcoin Core 31.1：当前版本发布说明](https://bitcoincore.org/en/releases/31.1/)