自动填充不生效 - 弹窗不出现或填充空白

症状分类

自动填充不工作的表现分几种：

按类别对症下药。

系统级自动填充没开

这是最常见的原因。按以下顺序检查：

步骤一：KeePassDX 内部开关

KeePassDX 设置 → 表单填充 → 自动填充服务或凭证提供程序服务，确认开关已打开。

某些版本有两个开关：

• 普通自动填充服务（旧版）
• 凭证提供程序服务（4.2.0+，支持 Passkey）

都开了。

步骤二：系统级选择

Android 12+：

• 设置 → 系统 → 语言和输入 → 自动填充 → 默认自动填充服务 → KeePassDX

Android 14+：

• 设置 → 安全 → 密码、密码密钥和自动填充 → KeePassDX

某些 ROM：

• 设置 → 其他设置 → 语言和输入法 → 自动填充服务

步骤三：应用内权限

对于目标应用（比如 Chrome、银行 App），检查是否禁用了自动填充：

• 某些安全敏感应用会自己禁用 Android 自动填充（银行 App 常见）
• 这种情况无解——用 Magikeyboard 兜底

MIUI/ColorOS 权限拦截

详见"MIUI 系统权限适配"页面。快速清单：

1. 设置 → 应用管理 → KeePassDX → 权限管理 → 打开以下：

• ✅ 后台弹出界面
• ✅ 显示在其他应用上层
• ✅ 生物识别
• ✅ 通知

1. 设置 → 应用管理 → KeePassDX → 省电策略 → 无限制
2. 如果以上还不行 → 关闭 MIUI 优化 → 重启

条目匹配不上

自动填充弹出的 KeePassDX 面板里条目为空，说明：

1. 条目的 URL 字段没填 → 编辑条目补上正确 URL
2. URL 不匹配 → 条目 URL 是 google.com，但当前页面是 mail.google.com（应该匹配，但某些情况下匹配失败）
3. 条目没有用户名/密码 → 自动填充需要至少有一个要填的字段

快速测试：在 KeePassDX 里手动打开一个确认有 URL 的条目，看自动填充面板能否匹配到。

表单控件不兼容

某些应用（游戏、金融 App、原生开发）的登录表单不遵循 Android 自动填充框架规范。表现为：

• 点击输入框时完全不触发自动填充
• 触发了但 KeePassDX 无法识别输入框类型（不知道哪个是用户名、哪个是密码）

解决办法：Magikeyboard 兜底。这个场景下 Magikeyboard 永远可靠。

浏览器内自动填充

Chrome/Edge 需要额外设置：

• Chrome → 设置 → 自动填充 → 使用其他服务进行自动填充 → KeePassDX

Firefox（118+）：

• Firefox → 设置 → 登录和密码 → 自动填充 → 开启（较新版本才支持）

终极排查

如果以上都不行：

1. 清除 KeePassDX 缓存（设置 → 应用管理 → KeePassDX → 存储 → 清除缓存）
2. 重启手机（某些 ROM 的权限变更需要重启才生效）
3. 查看日志（KeePassDX 设置 → 日志 → 找 Autofill 相关的 Error）
4. 重新安装 KeePassDX（清除所有数据后重来）