数据库打不开 - 原因排查与自救方法

先确认错误信息

KeePassDX 打不开数据库时会弹提示框显示错误信息。记下错误信息的完整文字（可以截图或复制到日志查看器里），然后对照以下分类排查。

最常见原因

1. 主密码错误

错误信息："无效的主密码或密钥文件"、"主密码不正确"

KeePassDX 的 Argon2d 密钥派生函数对错误密码不会快速告诉你失败——它会花完整的计算时间才返回"不匹配"。所以输入错密码后可能要等几秒才看到提示。

解决办法：

• 确认主密码没有输错大小写（区分大小写）
• 确认输入法没有切换成中文/其他语言（纯英文密码在中文输入法下可能输入乱码）
• 用密码提示（如果你写了）
• 用纸质备份找原始主密码
• 如果确定主密码正确但仍然打不开：见下一条

2. 密钥文件不匹配

错误信息："密钥文件不匹配"

如果你用了密钥文件 + 主密码双因子，两个都要对。密钥文件容易搞混：

• 选错了密钥文件（比如把另一个数据库的密钥文件拿来用了）
• 密钥文件被修改过（内容变了 → 哈希变了 → 不匹配）

解决办法：

• 找到备份的正确密钥文件
• 如果密钥文件有多个，逐个尝试（先从最新备份开始）

3. 数据库文件损坏

错误信息："文件格式无效"、"数据库文件哈希不匹配"、"打开时发生错误"

数据库文件可能因为以下原因损坏：

• 同步过程中断（Syncthing/Nextcloud 同步时关机）
• 存储介质问题（SD 卡坏块）
• Android 系统异常关闭 KeePassDX

解决办法：

1. 立刻备份当前损坏的 .kdbx 文件（防止后续恢复操作进一步损坏）
2. 用最近一次健康备份恢复（如果同步工具保留了文件版本，回去找上一个版本）
3. 用 KeePassXC（电脑上）尝试打开损坏的文件——KeePassXC 的数据库解析有时比 KeePassDX 更宽容
4. 看 KeePassDX 日志（设置 → 日志）找更具体的错误线索

4. KDBX 版本不兼容

错误信息："不支持的数据库版本"

极少数情况下，如果你用 KeePass 2.x 创建了一个 KDBX 3.1 旧格式数据库，而 KeePassDX 的某个新版本移除了对旧算法的支持。

解决办法：

• 用 KeePass 2.x 或 KeePassXC 打开旧数据库
• 另存为 KDBX 4.x 格式
• 传回手机再用 KeePassDX 打开

5. 路径/文件权限问题

错误信息："无法读取文件"、"权限被拒绝"

如果你选的数据库文件在：

• 某些云存储挂载目录（云存储 App 不支持标准文件访问）
• 加密的分区或容器
• 系统限制的目录

解决办法：

1. 把 .kdbx 从原位置复制到手机内部存储根目录
2. 再用 KeePassDX 打开
3. 确认可行后再慢慢移回同步目录

KeePassDX 打不开但 KeePassXC 能打开

这种情况罕见但存在：

• KeePassXC（电脑端）的数据库解析器比 KeePassDX 更宽容
• 某些 KDBX 3.1 数据库在 KeePassDX 新版本上打不开，但 KeePassXC 仍然能开
• 解决办法：用 KeePassXC 打开 → 另存为 KDBX 4.x → 传回手机

应急方案：从备份恢复

如果以上都试过还是打不开：

1. 找到最近的健康备份（数据库文件 + 密钥文件 + 主密码）
2. 把备份文件复制到手机内部存储
3. 打开 KeePassDX → 选新位置 → 输入正确凭证
4. 验证条目完整

这就是为什么定期备份如此重要。