Flutter FirebaseAuth 自动登出问题排查求助

1. 调试模式下的钥匙串权限问题 #

调试时iOS端Firebase Auth可能因钥匙串访问权限不足导致令牌无法持久化，需手动开启钥匙串共享：

• 打开Xcode，进入项目的Signing & Capabilities选项卡
• 添加Keychain Sharing功能，勾选对应钥匙串组（一般是$(TeamIdentifierPrefix)com.google.firebase.auth）
• 发布版本需确认GoogleService-Info.plist里的CLIENT_ID、REVERSED_CLIENT_ID与Firebase控制台完全一致

2. 修复Auth状态监听的冗余逻辑 #

你的Riverpod代码同时监听了authStateChanges()和userChanges()，且重复调用user.reload()，容易导致状态异常：

• 只保留一个监听即可（推荐authStateChanges()，仅在用户登录/登出时触发，更适配持久化状态追踪）
• 移除监听回调里的user.reload()，频繁的网络请求会干扰本地令牌读取

修改后的Riverpod示例代码：

@riverpod
class FirebaseAuthStateNotifier extends _$FirebaseAuthStateNotifier {
  late final StreamSubscription<User?> _authStateSubscription;

  @override
  Future<User?> build() async {
    _setupAuthListener();
    ref.onDispose(() => _authStateSubscription.cancel());
    
    // 初始化优先读取本地缓存的用户信息
    final currentUser = FirebaseAuth.instance.currentUser;
    return currentUser;
  }

  void _setupAuthListener() {
    _authStateSubscription = FirebaseAuth.instance.authStateChanges().listen((user) {
      if (user == null) {
        log('用户已登出');
        state = const AsyncValue.data(null);
      } else {
        log('用户已登录');
        state = AsyncValue.data(user);
      }
    });
  }

  void signOut() => FirebaseAuth.instance.signOut();
  void deleteCurrentUser() => FirebaseAuth.instance.currentUser?.delete();
  void sendEmailVerification() => FirebaseAuth.instance.currentUser?.sendEmailVerification();
}

3. 显式开启本地持久化配置 #

Firebase Auth默认启用移动端持久化，但可以显式配置确保生效，在Firebase.initializeApp()后添加：

await FirebaseAuth.instance.setPersistence(Persistence.LOCAL);

这会强制将令牌保存到设备安全存储中，避免意外丢失。

4. 排查令牌刷新与意外登出逻辑 #

• Firebase Auth的refresh token默认有效期较长，SDK会自动处理令牌刷新，无需手动保存，但要确保应用后台运行时没有被系统限制网络
• 检查项目中是否有其他代码意外调用signOut()或清除本地存储，导致Auth状态被重置

5. iOS系统权限检查 #

• 确认Info.plist中配置了必要的权限（如使用生物识别需添加NSFaceIDUsageDescription）
• 检查iOS系统隐私设置，确保应用未被限制访问钥匙串

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