Vaultwarden 与 Chrome Bitwarden 插件兼容性故障排查及修复记录

故障类型： 客户端与服务端 API 兼容性问题 影响范围： Chrome Bitwarden 浏览器插件 服务地址： https://xxxxx.com 部署环境： Ubuntu 22.04 + Docker Compose + Nginx + Cloudflare 一、故障概述 自托管 Vaultwarden 正常运行一段时间后，Chrome Bitwarden 插件出现无法加载密码库的问题。虽然插件提示同步成功，但无法正常显示密码条目；退出账户后重新登录，又出现“意外错误”。 通过浏览器开发者工具发现关键请求失败： POST https://xxxx.com/identity/accounts/prelogin/password 404 Not Found

排查发现，服务端实际运行 Vaultwarden 1.35.7，而新版客户端调用的预登录 API 在该版本中不可用。 最终通过备份持久化数据、拉取新版 Docker 镜像并重建容器解决问题。 二、根因分析 问题的核心并非账户密码错误，也不是密码库数据丢失，而是服务端与客户端之间的 API 兼容性。 需要特别注意： image: vaultwarden/server:latest

latest 并不代表运行中的容器会自动更新。Docker 容器创建后，即使远程镜像仓库发布了新版本，当前容器仍然运行原有镜像。 因此，单纯执行 docker restart 无法完成升级。 三、修复结果 用户已确认故障完全修复，Chrome 插件恢复正常使用。 本次记录可以作为后续遇到插件登录异常、同步成功但密码库为空、API 404 等问题时的排查参考。 以下将完整记录部署配置、排查命令、安全升级流程及预防措施。