前几天知乎上一个真实案例，值得每个自建密码库的人心里咯噔一下：有人把手机上的 Bitwarden 应用升级到 2026.7.1 之后，App 里的整个密码库突然消失，页面只剩下一个"导入密码"的提示。知乎
最迷惑的细节在这里：升级后第一次用自动填充，居然还是正常的；第二次开始才提示没有密码。事后推测，第一次填充读到的可能还是升级前留下的本地缓存，等客户端真正同步了一轮，问题才彻底暴露。知乎
如果你的 NAS 或家庭服务器上正好跑着 Vaultwarden，手机里的 Bitwarden 客户端又是自动更新的，这篇文章值得花三分钟看完。
第一步：先别修，先确认数据还活着
这时候最该做的不是动手修，而是判断"真丢了"还是"只是看不见"。案例里作者的做法值得抄：打开 Chrome 浏览器里的 Bitwarden 扩展，密码全都还在，正常可看。知乎
原理不难：Bitwarden 是零知识加密，密码库用你的主密码加密后存放在服务端，客户端只负责解密和展示。知乎App 只是一扇看向密码库的"窗户"，一扇窗户黑了，房子大概率没塌。
验证方法很简单：换一个设备——浏览器扩展、桌面客户端或另一台手机，登录同一个账号。只要能看到密码，就可以松一口气：这是兼容性问题，不是数据事故。
确认数据活着之后，有两个动作千万别做
不要顺手点"导入密码"。此时把一个不知道什么时候导出的本地备份文件导进当前密码库，旧数据很可能覆盖掉新条目，小事故直接升级成大事故。
不要一怒之下删容器、重装服务端。服务端本来就没问题，慌忙中把数据目录删了又没备份，假丢失就真成真丢失了。
为什么会中招：客户端和服务端，节奏永远不同步
官方 Bitwarden 客户端由应用商店自动更新，节奏完全不由你控制；而你自建的 Vaultwarden 容器，更新节奏全看自己——大多数人的默认设置是"没坏就不动"。网上的部署教程一搜一大把。小红书但几乎没人提醒你：服务端也要跟着更新。
这次的问题就出在这里：Bitwarden Android 2026.7.x 更新后，对服务端接口的要求变了，版本偏旧的 Vaultwarden（案例里是 1.36.0）接不住，客户端就读不出密码库；把服务端升级到 1.37.1 之后恢复正常。知乎
说白了，订阅制服务是平台替你扛兼容性，自建服务是你自己扛。这不是 bug，是自托管的成本——好在这成本可以管理。
修复三步走，前后不超过十分钟
案例作者走通的完整恢复路径如下，照抄就行。知乎
升级服务端。docker-compose 里固定了镜像版本的，把 vaultwarden/server 的版本号从旧版改成 1.37.1 或更新版本，重新拉取镜像并重启容器；从 NAS 应用商店装的，进容器管理界面检查更新，升完确认一眼版本号。
清除 App 数据。在手机的系统设置里，把 Bitwarden 的应用数据彻底清除，注意不是只清缓存。
重新登录。打开 App，填回自建服务器地址，登录，密码全部回来。
补一句：升级服务端之前，最好先把数据目录和数据库文件备份一份，万一升级过程出岔子，还有退路。
防复发的三条纪律
这个坑真正该补的不是版本号，是维护习惯：
服务端先行，客户端随后。每次升级完服务端容器，把各端客户端打开检查一遍；如果是客户端被商店强制更新了，尽快补上服务端版本。别让服务端版本号永远停在部署那天。
定个更新日。每一两个月挑一天，把密码库、相册这类关键自建服务的更新说明看一遍再升级。小步慢升，永远比攒一年一次性大跳跃安全。
数据库异地备份。Vaultwarden 的核心数据就是一个数据库文件（没用外部数据库的话就是 SQLite），密码条目、TOTP、安全笔记全在里面。给它安排一个每周备份到另一块盘或网盘的任务，这是 HomeLab 里最便宜的一份保险。
顺带一提：很多人还会从外网访问自建密码库，HTTPS 是必须的门槛，常见做法是在 NAS 上做反向代理或者走 Cloudflare Tunnel 这类内网穿透。哔哩哔哩这次事故之后，外出时也顺手试一下外部访问的地址通不通——手机的自动更新比家里服务器勤快，在外面先撞上的场景其实更常见。
最后说两句
这事不只是 Vaultwarden 的个案。所有"官方客户端 + 自建服务端"组合的服务——密码库、相册、音乐服务器——都有同一个病根：客户端被商店推着更新，服务端等你想起来才更新。最容易中招的，恰恰是照着教程装完、大半年没再碰过的人。
今天花三分钟做两件事：看一眼你的 Vaultwarden 服务端版本，确认数据库有没有备份。已经中招的也别慌，数据大概率没丢，三步就能找回来。
