Bitcoin Core 0.15.0.1 发布说明深度解析：GUI 崩溃修复、chainstate 格式迁移与 -reindex-chainstate 降级机制

本文以 Bitcoin Core 官方发布说明 release-notes-0.15.0.1.md 为主体，逐条解析 0.15.0.1 这个针对 0.15.0 的小幅修复版本：它修复了哪个具体的 GUI 启动崩溃问题、升级/降级操作为何涉及 chainstate 数据库与 fee_estimates.dat 的格式不兼容，以及 -reindex-chainstate 选项在源码层面是如何拦截并重建旧格式数据库的。读完本文，你可以掌握 0.15 系列版本升级的完整操作要点，并理解“格式不兼容→需要 reindex”这一机制在当前代码库中的实现位置。

一、0.15.0.1 是什么：0.15.0 的最小化补丁版本

发布说明开篇即明确了该版本的定位：

This is a minor bug fix for 0.15.0.

也就是说，0.15.0.1 不是常规的功能性小版本（如 0.15.1、0.15.2），而是专门针对 0.15.0 的一个缺陷修复补丁。其变更日志只有一条代码变更：

- #11332 `46c8d23` Fix possible crash with invalid nCustomFeeRadio in QSettings (achow101, TheBlueMatt)

此外，发布说明还附带提到：0.15.0 发布时遗漏了 manpage（手册页）更新，在 0.15.0.1 中一并补上了。对应的手册页文件在当前仓库中可以查看：bitcoind.1、bitcoin-cli.1、bitcoin.1 等。

二、Notable change：GUI 启动崩溃问题（nCustomFeeRadio）

0.15.0.1 唯一的实质性修复，解决的是 0.15.0 GUI（bitcoin-qt）在特定配置下的启动崩溃。发布说明原文如下：

After upgrade to 0.15.0, some clients would crash at startup because a custom fee setting was configured that no longer exists in the GUI. This is a minimal patch to avoid this issue from occurring.

2.1 崩溃成因

Bitcoin Core 的 Qt GUI 使用 Qt 的 QSettings 持久化用户的界面设置。在 0.15.0 之前的版本中，发送对话框里存在一个“自定义手续费（custom fee）”相关的单选项组，其选择状态以 nCustomFeeRadio 键写入 QSettings。0.15.0 重构了该费用界面，移除了这一单选项组——但用户磁盘上旧版本写下的 nCustomFeeRadio 值仍然留在 QSettings 中。当 0.15.0 启动时读取这个已经不对应任何有效枚举值的旧键，程序没有做防御性处理，从而导致崩溃。

这是一个典型的“配置迁移缺陷”：界面结构变了，但旧配置值的兼容性处理缺失。0.15.0.1 采用的是最小补丁策略（minimal patch），即不改变 0.15.0 的其他行为，只对该无效值做保护性处理，避免启动崩溃。

2.2 该问题的后续结局

值得注意的是，从源码演进看，这个临时性的保护并不是长久之计。紧随其后的 0.15.1 发布说明中记录了彻底的处理方式：

- #11334 `19d63e8` Remove custom fee radio group and remove nCustomFeeRadio setting (achow101)

见 release-notes-0.15.1.md：0.15.1 直接删除了整个自定义手续费单选项组以及 nCustomFeeRadio 设置项，从根本上消除了这一遗留键。在当前代码库中搜索 nCustomFeeRadio 已无任何源码命中，说明该设置已从代码库中完全清除——这印证了“0.15.0.1 是止血补丁、0.15.1 是根除修复”的版本演进脉络。

三、升级操作（How to Upgrade）

发布说明给出的升级步骤是标准的 Bitcoin Core 升级流程，完整继承如下：

1. 先彻底关闭旧版本。如果是老版本，关闭后需要等待它完全退出（老版本可能耗时几分钟才能干净退出）；
2. 按平台替换程序文件：
   • Windows：运行安装程序；
   • macOS：覆盖 /Applications/Bitcoin-Qt；
   • Linux：覆盖 bitcoind / bitcoin-qt 二进制文件。

3.1 chainstate 数据库格式转换（0.15.0 首次运行时发生）

发布说明强调：

The first time you run version 0.15.0 or higher, your chainstate database will be converted to a new format, which will take anywhere from a few minutes to half an hour, depending on the speed of your machine.

即：从 0.15.0 开始，chainstate（UTXO 状态）数据库采用了新格式。第一次以 0.15.0+ 运行时会自动转换，耗时几分钟到半小时不等。对从旧版本升级到 0.15.0.1 的用户而言，这一次转换在升级到 0.15.0 时已经发生过，0.15.0.1 本身不再引入新的格式变更。

3.2 fee_estimates.dat 文件格式变更

The file format of fee_estimates.dat changed in version 0.15.0. Hence, a downgrade from version 0.15.0 or upgrade to version 0.15.0 will cause all fee estimates to be discarded.

fee_estimates.dat 是节点本地手续费估计器的持久化文件。由于 0.15.0 变更了它的文件格式，凡是跨越 0.15.0 边界的上行或下行升级，所有已积累的手续费估计数据都会被丢弃。这与 0.15.0 自身的发布说明（见 release-notes-0.15.0.md）一致——0.15.0.1 作为 0.15.0 的补丁，自然继承了这一行为。

当前代码库中仍保留着对旧版该文件的兼容处理逻辑：estimator_args.cpp 中定义了 LEGACY_FEE_ESTIMATES_FILENAME{"fee_estimates.dat"}，启动时如果存在旧路径的 legacy 文件，会将其迁移（rename）到当前手续费估计器的路径；迁移失败则放弃旧数据、以全新估计开始（日志输出 "Continuing with fresh estimates"）。这与发布说明描述的“估计数据被丢弃”行为相互印证。

3.3 与更老版本的关系

发布说明同时提示了一条长期兼容边界：

The block database format also changed in version 0.8.0 and there is no automatic upgrade code from before version 0.8 to version 0.15.0. Upgrading directly from 0.7.x and earlier without redownloading the blockchain is not supported. However, as usual, old wallet versions are still supported.

即：0.8.0 曾变更区块数据库格式，因此从 0.7.x 及更早版本直接升级到 0.15.0.1 而不重新下载区块链是不支持的；但旧格式的钱包文件依旧支持。

四、降级警告（Downgrading warning）与 -reindex-chainstate

这是本文档对运维最关键的段落：

The chainstate database for this release is not compatible with previous releases, so if you run 0.15 and then decide to switch back to any older version, you will need to run the old release with the -reindex-chainstate option to rebuild the chainstate data structures in the old format.

If your node has pruning enabled, this will entail re-downloading and processing the entire blockchain.

要点拆解：

1. 单向兼容：0.15 系列写入的 chainstate 数据库，旧版本无法直接读取。降级必须配合 -reindex-chainstate 以旧格式重建 chainstate 数据结构；
2. 修剪节点的代价：若节点启用了 pruning（磁盘修剪），-reindex-chainstate 只能从本地 blk*.dat 重建，而修剪节点可能已删除旧区块文件，因此意味着需要重新下载并处理整条区块链。

4.1 源码印证：旧版本为何会“拒绝”新格式数据库

虽然 0.15.0.1 年代的具体代码已随版本演进而变化，但该机制在当前代码库中依然清晰可查，可以说明“格式不兼容→报错→提示 reindex”的完整链路：

• 参数定义：init.cpp 中注册了该选项：

  argsman.AddArg("-reindex-chainstate", "If enabled, wipe chain state, and rebuild it from blk*.dat files on disk. ...");
  

  与 init.cpp 的 -reindex（同时清空 chain state 与 block index）形成对照。
• 不兼容拦截：node/chainstate.cpp 中，加载 coins 数据库时会调用 CoinsDB().NeedsUpgrade() 检查数据库版本；若磁盘上的 chainstate 数据库是更新版本写入的（旧版本二进制读到新格式时即为“需要升级”状态），直接以 FAILURE_INCOMPATIBLE_DB 失败并给出提示：

  if (chainstate->CoinsDB().NeedsUpgrade()) {
      return {ChainstateLoadStatus::FAILURE_INCOMPATIBLE_DB,
          _("Unsupported chainstate database format found. Please restart with -reindex-chainstate. This will rebuild the chainstate database.")};
  }
  

  注意注释明确写道：“This is a no-op if we cleared the coinsviewdb with -reindex or -reindex-chainstate”——即先清空数据库后，这个检查自然通过，随后从 blk*.dat 重放重建。
• 与修剪模式的互斥：init.cpp 中启动期即校验：

  if (args.GetBoolArg("-reindex-chainstate", false)) {
      return InitError(_("Prune mode is incompatible with -reindex-chainstate. Use full -reindex instead."));
  }
  

  这与发布说明中“pruning 节点需要重新下载整条链”的警告一致：在 prune 模式下连 -reindex-chainstate 这条路都被禁止，只能走完整 -reindex（等价于重下区块链）。

4.2 测试用例佐证

仓库的功能性测试直接覆盖了这一机制，可以作为可验证依据：

• feature_reindex.py：专门测试 bitcoind 带 -reindex 与 -reindex-chainstate 启动后能否正确重建并追平链尖；
• feature_pruning.py：验证 -prune=550 与 -reindex-chainstate 同时启用时，节点按预期报错退出（Prune mode is incompatible with -reindex-chainstate. Use full -reindex instead.）；
• feature_unsupported_utxo_db.py：专门模拟“遇到不支持的 UTXO 数据库格式”的场景，验证节点拒绝启动并提示 Please restart with -reindex-chainstate，随后带参重启可恢复。

五、兼容性（Compatibility）

发布说明给出的平台支持范围：

Bitcoin Core is extensively tested on multiple operating systems using the Linux kernel, macOS 10.8+, and Windows Vista and later. Windows XP is not supported.

Bitcoin Core should also work on most other Unix-like systems but is not frequently tested on them.

即：经过充分测试的平台为 Linux 内核、macOS 10.8+、Windows Vista 及以上；Windows XP 明确不支持。其他类 Unix 系统“应该可以工作”，但不被频繁测试——属于尽力支持（best effort）范畴。

六、变更日志汇总与本版本的价值定位

项目	内容
代码变更	#11332 46c8d23 — Fix possible crash with invalid nCustomFeeRadio in QSettings（achow101, TheBlueMatt）
文档变更	补上 0.15.0 遗漏的 manpage 更新
数据文件影响	无新增格式变更；继承 0.15.0 的 chainstate 新格式与 fee_estimates.dat 格式变更
贡献者	Andrew Chow、Matt Corallo、Jonas Schnelli、Wladimir J. van der Laan，以及翻译贡献者

从版本策略角度看，0.15.0.1 展示了 Bitcoin Core 对“阻塞性回归”的处理方式：用极小的补丁版本（.x.1）快速止血，而不等待下一个常规小版本；随后在 0.15.1 中以更彻底的重构（#11334）清除技术债。对于部署了 0.15.0 且遭遇 GUI 崩溃的用户，升级到 0.15.0.1 是零数据格式风险的最低成本方案（两个版本之间没有数据库格式差异）。

七、相关文档与延伸阅读

• 主文档：release-notes-0.15.0.1.md
• 前一版本（0.15.0 完整功能说明，含 SegWit 支持、addwitnessaddress RPC 等）：release-notes-0.15.0.md
• 后续版本（移除 nCustomFeeRadio 的 0.15.1）：release-notes-0.15.1.md
• reindex 机制实现：init.cpp、node/chainstate.cpp
• 手续费估计文件迁移逻辑：policy/fees/estimator_args.cpp
• 行为验证测试：feature_reindex.py、feature_unsupported_utxo_db.py、feature_pruning.py

适用前提提醒：本文所述平台兼容性与升级行为以 0.15.0.1 发布说明为准，反映的是该历史版本的支持矩阵；-reindex-chainstate 的源码级解析基于当前代码库实现，其参数语义在当前版本中已扩展（例如还涉及 assumeutxo 快照 chainstate 的清理），但在“旧版本读取新版 chainstate 数据库即拒绝启动并提示重建”这一核心行为上与 0.15 时代保持一致。