自建Vaultwarden手机端无法登录问题解决方案

本文记录了自建Vaultwarden(Bitwarden)服务后，手机端无法登录以及更新后出现"Your local data is too old to be migrated"错误的完整解决过程。

问题背景

最近在使用自建的Vaultwarden密码管理服务时，遇到了手机端无法正常登录的问题。在社区寻找解决方案的过程中，按照建议更新了服务端版本，结果又遇到了新的问题。

问题一：手机端无法登录

问题描述

自建Vaultwarden后，网页端可以正常登录使用，但手机端（Android/iOS）的Bitwarden客户端无法连接到自建服务器，提示无法处理请求或连接失败。

解决思路

参考Linux.do社区的讨论帖，初步判断是服务端版本过旧导致的兼容性问题。

解决方案

1. 检查当前Vaultwarden版本

# 如果使用Docker部署，查看当前运行的版本
docker ps | grep vaultwarden

2. 更新到最新版本

我是用的unraid, 直接把版本号固定了

# 停止当前容器
docker stop vaultwarden

# 拉取最新镜像（注意：latest标签可能不是最新版本）
docker pull vaultwarden/server:latest

# 或者指定具体版本号
docker pull vaultwarden/server:1.35.2

# 重新启动容器
docker start vaultwarden
# 或者使用docker-compose up -d重新部署

3. 版本兼容性说明

• Vaultwarden服务端和Bitwarden客户端之间存在版本兼容性要求
• 建议服务端保持在较新的版本
• 客户端也需要更新到与服务端发布时间相近的版本

问题二：Your local data is too old to be migrated

问题描述

按照上述方法更新服务端后，访问Web端时登录界面一直转圈, F12控制台出现新的错误提示：

Your local data is too old to be migrated
Your current state version is 1, but minimum version is 2

问题原因

这个错误与服务端无关，而是浏览器本地缓存的问题。旧版本的Web Vault在浏览器中存储了状态数据（localStorage），但新版本的Web Vault无法兼容这些旧数据，导致迁移失败。

解决方案

参考GitHub Issue #4846的解决方案：

方法一：清除浏览器缓存（推荐）

1. 打开浏览器开发者工具（F12）
2. 切换到 Application 或 存储 标签页
3. 在左侧找到你的Vaultwarden域名
4. 清除以下内容：
   • Local Storage（本地存储）
   • Session Storage（会话存储）
   • Cookies（可选）
5. 刷新页面，重新登录

方法二：使用无痕/隐私模式

打开浏览器无痕模式 → 访问Vaultwarden地址 → 登录测试

如果无痕模式可以正常登录，说明确实是浏览器缓存问题。

方法三：手动清除localStorage（开发者工具）

1. 打开开发者工具（F12）
2. 切换到 Console 控制台标签页
3. 输入以下命令并执行：

localStorage.clear();
sessionStorage.clear();
location.reload();

方法四：更换浏览器

如果上述方法都不行，可以尝试使用其他浏览器访问，排除浏览器特定问题。

测试结果

按照方法一清除浏览器本地存储后，页面刷新，可以正常访问登录界面。登录后数据完整，手机端也能正常同步。

完整解决步骤总结

第一步：更新Vaultwarden服务端

docker pull vaultwarden/server:latest
docker-compose down
docker-compose up -d

第二步：清除浏览器缓存

• 打开开发者工具（F12）
• Application → Local Storage → 清除你的域名数据
• 刷新页面

第三步：重新登录

• Web端重新登录验证
• 手机端登出后重新登录
• 测试数据同步是否正常

附加建议

1. 版本管理

• 不要盲目追求latest标签，建议指定具体版本号
• 关注Vaultwarden Releases的更新日志
• 更新前做好数据备份

2. 客户端兼容性

• Bitwarden客户端版本尽量与Vaultwarden发布时间相近
• 如果服务端是2023年中期版本，客户端也应该使用相近时间发布的版本
• 避免使用太老或太新的客户端版本

3. 手机端常见问题排查

• 确认服务器地址填写正确（包含https://）
• 检查SSL证书是否有效
• 确认防火墙/端口是否开放
• 在Admin面板中检查用户会话，必要时清除旧会话

4. 数据备份

更新前务必备份重要数据：

# 备份数据目录
cp -r /path/to/vaultwarden/data /path/to/backup/data-$(date +%Y%m%d)

# 或者导出数据库
docker exec vaultwarden sqlite3 /data/db.sqlite3 ".backup /data/backup.sqlite3"

参考资料

• Linux.do Vaultwarden讨论帖
• GitHub Issue #4846 - Your local data is too old to be migrated
• Vaultwarden官方文档

总结

自建Vaultwarden服务时，版本兼容性是最常见的问题来源。遇到问题时：

1. 先确认服务端版本是否过旧
2. 更新后如遇到浏览器相关错误，优先考虑清除缓存
3. 保持服务端和客户端版本的相对同步
4. 定期备份数据，更新前做好回滚准备

希望这篇文章能帮助到遇到类似问题的朋友。如果还有其他问题，欢迎在评论区交流讨论。