比特币加密钱包改密码：walletpassphrasechange 换的是哪把锁

三个命令各管一件事

比特币核心的钱包加密相关的 RPC 至少有三个，分工很容易被混为一谈。encryptwallet 负责给一个原本明文的钱包文件第一次加上加密；walletpassphrase 负责在一段时间内把解密后的密钥留在内存里，让钱包可以临时签名；walletpassphrasechange 则只干一件事：把解密用的口令从旧密码换成新密码。也就是说，第一个决定”锁装不装”，第二个决定”锁开多久”，第三个决定”钥匙的齿形怎么换”。本文只谈第三个。

改密码时，什么会变、什么不会变

调用 walletpassphrasechange 只需要旧口令和新口令两个参数，源码层面它主要拦截两种情况：钱包根本没加密时直接报错，正在带口令扫描链时会要求先停扫描。建议在钱包锁定状态下完成更换，避免解锁窗口中间换锁的混乱。成功之后会变化的只有一层：用来加密钱包内私钥的那把”口令锁”。不会变化的东西恰恰是用户最关心的那些：钱包的密钥派生结构不变，派生路径不变，已经收过款的地址不变，地址对应的公钥和私钥本身也不变，只是私钥在磁盘上换了一把口令来封装。也正因为私钥和派生关系没动，你在改口令之前做的钱包文件备份和描述符备份在恢复时依然能用——恢复时你需要记得的，是那台机器恢复完成后要用”新口令”解锁，而如果备份是很早以前生成的，当时的钱包可能甚至还没加密，那就要按当时状态的口令（也就是不设口令）来打开。

需要提醒一个容易踩的坑：网上常见的”加密钱包等于换新种子”的说法并不适用于所有时点。在早期版本的旧式钱包文件上第一次执行加密时，软件曾经采取过”换一套新 HD 种子”的做法，因此第一次 encryptwallet 之后要求重新备份。而 walletpassphrasechange 不属于那种场景，它只是同一条密钥链上的口令轮换，改完之后原有备份的密钥内容仍然有效。区分这两类操作，是判断”要不要重做备份”的关键：凡是可能改动种子或描述符集合的操作，做完都要重新备份；单纯换口令不需要，但建议顺手把钱包文件按新状态再存一份，成本很低。

解锁空档与口令的暴露边界

walletpassphrase 带一个以秒计的 timeout 参数，钱包在这段时间里保持可签名状态；在已解锁状态下再次调用它会用新时长覆盖旧时长。这个”空档”挡不住已经在读你内存或磁盘的恶意程序，它挡的是无人值守时的误操作和短暂离开工位场景。另一个细节是：解锁时长参数存在一个很长的上限（源码里以约三年为封顶），但那不代表可以理所当然地长期常开——常开钱包等于把加密退化成摆设。改口令的正确姿势是先让钱包回到锁定状态，再执行 walletpassphrasechange；如果给未加密钱包调用它，节点会直接报错提示当前钱包并未加密。

实操顺序建议

1. 确认钱包当前状态：先试一次带旧口令的解锁，确认旧口令确实还生效。
2. 选择锁定状态下改口令，避免解锁窗口内更换导致的状态混乱。
3. 改完立即用新口令做一次”解锁再锁定”验证，再发起一笔测试性质的小额发送（金额自选，注意这会产生真实链上手续费）。
4. 把钱包文件和描述符列表各备份一份，并在备份介质上标注新的打开口令。
5. 如果你启用了任何依赖钱包的后台服务（对账脚本、收付接口），记得同步更新它们读取口令或解锁流程的配置。

口令本身的安全仍是第一道防线：改一个只出现在钱包口令里的、别的网站从不使用的长口令，比频繁轮换短口令更有效。涉及真实资产的操作建议先在小额资金上演练一轮。本文只介绍软件功能与操作边界，不构成任何投资建议。