小米账号登录失败排查——闪退、Authkey 失效、二次验证

登录闪退

这是最常见的问题，特别在 Android 非 WebView 版本上。解决方法详见 Android 闪退，核心是：

1. 卸载当前 AstroBox
2. 下载带 WebView 的 Android 版本
3. 或者更新系统 WebView 到最新版

Authkey 自动失效

为什么会失效

小米的 Authkey 是有时效的安全凭据——过一段时间小米会自动更新 Authkey 用于你的设备。AstroBox 理论上应该自动同步这个更新，但有时会出现延迟或失败。

症状

• 之前连接好的设备突然断开
• 重新连接提示 Authkey 无效
• 设备列表里显示 Authkey 已过期

解决方法

方法一：重新登录小米账号

1. 设置 → 账号设置 → 更多设置
2. 退出小米账号（如果已登录）
3. 重新登录小米账号
4. AstroBox 会自动拉取最新 Authkey

方法二：手动强制同步

如果不想重新登录：

1. 小米账号设置里找到「同步」按钮
2. 点一下强制重新拉取设备列表和 Authkey

方法三：开关「Authkey 自动覆盖」

设置 → 账号设置 → 小米账号 → Authkey 自动覆盖。如果之前关掉了这个选项，可能导致不会自动更新 Authkey。打开它。

二次验证卡住

为什么会卡住

小米账号登录时有时需要二次验证（短信、安全令、人脸等），这是小米的安全机制。

症状

• 输入账号密码后弹出二次验证
• 验证完成后页面没有自动跳回 AstroBox
• 或者验证页面加载不出来

解决方法

iOS / macOS 用户：

1. 先完成二次验证
2. 验证页面完成后，系统会自动触发 AstroBox 的 OAuth 回调
3. 如果没触发，手动打开 AstroBox，应该已经登录好了

Android 用户：

1. 用系统浏览器打开小米登录页（如果 AstroBox 内置 WebView 卡了）
2. 完成二次验证
3. 回到 AstroBox

桌面端（Windows / Linux）：

1. 二次验证在系统默认浏览器中完成
2. 完成后浏览器会跳转回 AstroBox 的本地回调地址
3. 如果没自动跳转，手动关闭浏览器，回到 AstroBox 看看

如果二次验证完全没弹出

• 确认 AstroBox 版本是 2.0+（老版本的小米账号登录实现有问题）
• 试试换 Authkey 手动连接代替账号同步

多设备混淆

如果你的小米账号下绑定了多个穿戴设备：

1. 登录后 AstroBox 会一次性拉取所有设备
2. 设备列表里应该能看到全部
3. 逐一连接即可
4. 如果某台设备没出现，点「重新同步」

账号安全相关

小米账号密码被改了

如果你的小米账号密码被修改过：

1. AstroBox 里之前的小米登录会话会过期
2. 下次打开会提示重新登录
3. 正常重新登录即可

小米账号被冻结

小米账号异常行为被冻结的话：

1. 去小米账号官方解冻页面操作
2. 解冻后再回到 AstroBox 登录

总结：万能修复流程

小米账号登录出问题时，按这个顺序试：

1. 换带 WebView 的版本（解决 Android 闪退）
2. 退出重登 AstroBox 账号 + 小米账号
3. 强制同步设备（小米账号设置里点同步）
4. 重启 AstroBox + 重启手机/电脑
5. 切换到 Authkey 手动连接（绕过账号同步）
6. 升级 AstroBox 到最新版本