Firebase用户登录后偶发无认证状态问题排查求助

核心根因 #

该问题的触发和12小时未登录的场景强相关，本质是Firebase Auth状态同步的异步延迟问题：Firebase ID token默认有效期仅为1小时，用户长时间未登录后冷启动应用时，Firebase SDK会在后台静默刷新ID token，这个刷新过程和跳转后视图的接口调用存在概率性的时序差，导致请求携带的是过期token，后端无法识别到有效认证信息。

可行解决方案 #

• 接入Auth状态监听替代登录回调判断认证状态
  不要仅依赖登录接口的回调结果判定用户已完成认证，而是通过Firebase官方提供的状态监听器确认认证状态完全生效后，再执行需要鉴权的接口请求：

// 全局或根视图初始化时注册监听
Auth.auth().addStateDidChangeListener { auth, user in
    if let _ = user {
        // 认证状态已生效，允许跳转下一页/调用业务接口
        self.isAuthValid = true
    } else {
        self.isAuthValid = false
        // 未认证跳转登录页
    }
}

• 接口调用前强制刷新ID token
  首次启动或长时间未登录后调用Functions接口前，先手动触发token刷新，确保携带的是有效token：

guard let currentUser = Auth.auth().currentUser else {
    // 无有效登录态，跳转登录
    return
}
// 强制刷新token，避免使用本地缓存的过期token
currentUser.getIDTokenForcingRefresh(true) { [weak self] token, error in
    guard error == nil, token != nil else {
        // token刷新失败，处理登录异常
        return
    }
    // 刷新成功后再调用业务接口
    Functions.functions().httpsCallable("api-report").call() { result, error in
        // 处理接口返回结果
    }
}

• 新增认证错误自动重试机制
  针对返回failed-precondition的认证错误，增加最多2次的自动重试逻辑，避开token刷新的时序差窗口：

func requestReportApi(retryTimes: Int = 0) {
    Functions.functions().httpsCallable("api-report").call() { [weak self] result, error in
        // 判定是否为认证类错误，且未达重试上限
        if let err = error as NSError?,
           err.domain == FunctionsErrorDomain,
           err.code == FunctionsErrorCode.failedPrecondition.rawValue,
           retryTimes < 2 {
            DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
                self?.requestReportApi(retryTimes: retryTimes + 1)
            }
            return
        }
        // 正常处理接口结果
    }
}

• 优化登出逻辑触发时机
  如果业务没有强制要求切后台立即登出，建议仅在用户主动点击登出按钮时执行登出逻辑，避免应用退后台后被系统挂起，导致登出逻辑执行不完整，出现本地session状态和Firebase Auth状态不一致的问题。
• 避免提前初始化Callable实例
  不要在用户登录前就初始化self.function实例，每次调用接口时动态创建httpsCallable实例，避免实例缓存旧的无认证状态。

内容的提问来源于stack exchange，提问作者Joseph Alvini