日志查看器 - 排查 KeePassDX 问题的利器

日志是什么

KeePassDX 在运行过程中会记录各种操作事件到日志文件里：

• 数据库打开/关闭/保存
• 凭证解锁/主密码验证
• 自动填充请求和响应
• Magikeyboard 操作
• Passkey/WebAuthn 协议交互
• 文件读写和权限错误
• 加密/解密错误
• 版本更新信息

当 KeePassDX 出现问题时，日志文件是定位根因的唯一可靠信息源。

打开日志查看器

KeePassDX 设置 → 关于 → 日志（或某些版本在设置里直接有"日志"入口）。

日志查看器界面：

• 按时间倒序显示事件
• 每条记录包含：时间戳、日志级别、模块、消息
• 可以按级别过滤（只看 Error、只看 Warning）
• 可以复制整条日志到剪贴板

日志级别

排查问题时优先看 Error 和 Fatal 级别。

常见问题的日志线索

数据库打不开

在日志里找：

• Invalid master password or keyfile → 主密码或密钥文件不对
• Database file hash mismatch → 数据库文件被修改或损坏
• Unsupported database version → KDBX 版本不兼容（太旧的 KDBX 4.x 版本）
• Key derivation failed → Argon2d 参数异常

自动填充不生效

在日志里找：

• Autofill service not enabled → 系统级自动填充服务没开启
• No credential provider found → 系统没检测到 KeePassDX 的服务
• Form field not recognized → 应用的表单控件格式不兼容
• Permission denied → KeePassDX 缺少权限（MIUI 的后台弹出界面权限等）

Magikeyboard 打不开数据库

• Magikeyboard connection lost → Magikeyboard 和 KeePassDX 主进程通信断开
• Database not unlocked → 数据库还没开（Magikeyboard 需要主进程里的数据库已解锁）
• Background process killed → KeePassDX 被系统省电策略杀掉了

Passkey 创建/登录失败

• WebAuthn ceremony failed → WebAuthn 协议交互失败
• User verification required but disabled → 需要 UV 但数据库打开时禁用了
• Relying party origin mismatch → 域名绑定不匹配（钓鱼检测）

导出日志

日志查看器里有"导出日志"按钮，可以把日志内容复制到剪贴板，或保存为文本文件。

提交 Issue 时附上日志

向 KeePassDX 开发者报告 Bug 时，日志文件是最有用的信息之一。GitHub Issues 模板通常会要求附上日志。

提交前注意：

• 日志里可能包含数据库路径（如 /storage/emulated/0/keepass/personal.kdbx）
• 不包含主密码、凭证内容、附件等敏感数据
• 如果介意路径信息，可以编辑掉后再提交

日志文件位置

KeePassDX 的日志文件存在应用内部存储里（Android data/com.kunzisoft.keepass.free/），普通文件管理器看不到（需要 root 或用 KeePassDX 内置导出功能）。

所以不要尝试用文件管理器手动找日志——用 KeePassDX 内置的日志查看器和导出功能就好。