microg 中文文档 下载 App

登录失败与认证报错的处理办法

先分清两侧故障

框架侧:在 microG 设置里添加账号就失败(转圈、报错)。应用侧:microG 里账号正常,但应用内登录谷歌时报错。两侧处置完全不同。

框架侧登录失败的排查

  1. 网络环境:登录要直连谷歌认证服务器,网络不通一切免谈。
  2. 系统时间:设备时间不准会让认证直接失败,开自动对时再试。
  3. 两步验证:开了两步验证的账号走完整验证流程,别在验证码环节中断。
  4. 版本因素:账号认证有过登记在案的版本缺陷(如某版本的重大回归),升级到最新稳定版是最省事的绕过。
  5. 重试节奏:连续失败可能触发临时限制,歇一会儿再试。

应用侧登录失败的排查

  1. 确认账号在场:microG 里没有账号,应用侧自然无从登录——先完成 添加账号。
  2. Firebase 登录的边界:应用若用 Firebase 认证,microG 只支持匿名、邮箱密码、手机号、自定义令牌几种方式;"用谷歌账号登录 Firebase"这类方式在部分版本下支持不全,属已知边界。
  3. 清应用数据重登:应用本地缓存的旧令牌失效是掉线主力,清数据后重走登录。
  4. 交叉验证:另一个应用用同一账号登录正常 → 问题在原应用;两个都失败 → 回框架侧排查。

掉线频繁的情况

认证相关数据流参考 登录时发送了什么。