dumptxoutset如何生成UTXO快照？

dumptxoutset不是普通备份命令。它把某个链状态的UTXO集合序列化为快照，latest与rollback会走不同路径；尤其rollback期间，节点会临时回到历史状态并暂停网络活动。若没有维护窗口和输出验收，快照文件即使生成，也可能缺少可复现的基准和使用条件。

先选择模式，再决定停机影响

dumptxoutset把序列化UTXO集合写入文件，之后只有在该快照高度受链参数支持时才能用于loadtxoutset。

除latest模式外，节点会临时回滚到目标高度并暂停网络活动，官方不建议此时并行调用涉及区块存储的RPC。

“生成成功”不代表任意快照都可被生产版本loadtxoutset。官方说明目标高度需要受chainparams支持。计划阶段先核对网络、Bitcoin Core版本、支持的快照基准和用途，不把主网、测试网或不同版本生成的文件混在同一目录。

官方不建议在非latest路径执行时并行调用涉及区块存储的RPC，因为节点正在临时回滚状态。开始前摘除业务流量，暂停索引器、钱包扫描、备份和区块查询，记录最佳区块哈希与高度。其他监控可保留进程级观察，但不要把暂时停止推进直接触发自动重启。

调用可能持续数分钟，官方示例使用rpcclienttimeout=0；rollback目标距链尖越远通常耗时越长。生产自动化要有外部观察超时，而不是无限等待后无状态：记录进程是否存活、磁盘是否增长和命令开始时间。客户端连接断开时先检查输出文件、日志和节点状态，避免盲目重新运行覆盖结果。

返回值包含coins_written、base_hash、base_height、绝对路径、txoutset_hash与nchaintx。

coins_written说明写入的UTXO数量；base_hash与base_height标识基准区块；path给出实际绝对路径；txoutset_hash用于核对集合内容；nchaintx是截至基准区块的链交易数。保存完整JSON，不只复制文件名。

文件落盘后计算额外文件级SHA-256，并记录大小、权限、创建主机、客户端版本和生成时间。txoutset_hash是UTXO集合口径，文件hash是传输与存储口径，两者用途不同，不能互相替代。交接时同时提供两类hash和基准区块。

loadtxoutset将快照加载为第二条chainstate并在后台继续原始链状态验证，第三方快照内容会按hash检查。

加载快照会建立第二条chainstate，让节点较快跟上链尖；原始chainstate仍在后台验证到快照基准。第三方快照可用，是因为内容会按预期hash检查，而不是因为发布者被无条件信任。运营看板要同时展示快照链状态与背景验证进度。

不要把“节点已经能服务链尖”误写成“全历史已经完成验证”。在背景验证完成前，升级、故障或资源限制可能影响进度。关键服务设定接受条件：哪些RPC可用、哪些任务必须等背景验证完成、如何识别异常chainstate。

生成端核对返回字段、文件hash、节点恢复链尖和网络连接；加载端在隔离环境验证目标版本接受快照，核对base、coins_loaded、同步、关键UTXO样本和背景验证。失败时保留原文件与日志，不在唯一快照上修补字节。

快照不包含钱包私钥、mempool或完整历史区块，不能替代钱包备份和链数据归档。本文用于Bitcoin Core UTXO快照生成与验收，不建议从不可信渠道执行任意文件，也不构成资产恢复保证。

快照交付必须带着基准和hash。复核时必须绑定具体版本、节点或查询上下文，不能把一次成功结果扩写成长期保证。

资料访问时间为2026-08-12。尚需持续复核：并非任意自建快照高度都能被生产版本loadtxoutset接受；文章不承诺跨版本、跨网络或未登记高度兼容。

相关站内主题：UTXO集合统计、chainstates快照进度、mempool导入检查。本文用于技术教育、数据理解或防御性运维，不构成投资、收益、交易或资产安全承诺。