Flutter中如何通过Firebase Auth实现用户关闭APP后保持登录状态

Firebase Auth 本身默认会自动持久化用户会话，关闭APP或清除内存后仍能保留登录状态。出现自动登出的问题，通常是配置或代码逻辑的问题，以下是具体排查和解决步骤：

1. 确认持久化策略设置正确 #

Firebase Auth 提供三种持久化策略：

• Persistence.LOCAL：默认值，持久化到设备本地，APP重启或清除内存后仍保留
• Persistence.SESSION：仅在当前APP会话有效，清除内存后失效
• Persistence.NONE：不持久化，APP重启后自动登出

确保你没有主动设置为后两种，登录前可以显式指定LOCAL策略：

await FirebaseAuth.instance.setPersistence(Persistence.LOCAL);
// 执行登录操作
await FirebaseAuth.instance.signInWithEmailAndPassword(
  email: "user@example.com",
  password: "password123",
);

2. 正确初始化Firebase并监听用户状态 #

不要在APP启动时仅一次性检查FirebaseAuth.instance.currentUser，因为持久化的用户信息可能需要一点时间加载完成，直接判断会导致误判为未登录。正确做法是通过流监听用户状态变化：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: StreamBuilder<User?>(
        stream: FirebaseAuth.instance.authStateChanges(),
        builder: (context, snapshot) {
          // 等待用户状态加载完成
          if (snapshot.connectionState == ConnectionState.waiting) {
            return SplashScreen(); // 启动页/加载页
          }
          // 根据用户状态跳转页面
          return snapshot.hasData ? HomePage() : LoginPage();
        },
      ),
    );
  }
}

3. 排查平台特定配置问题 #

Android 端 #

确保你的AndroidManifest.xml中没有禁用SharedPreferences相关权限，Firebase Auth 依赖SharedPreferences存储会话信息，默认情况下权限是开启的，无需额外配置。

iOS 端 #

Firebase Auth 依赖Keychain存储会话，需要在Info.plist中添加Keychain访问权限：

<key>keychain-access-groups</key>
<array>
  <string>$(AppIdentifierPrefix)com.your.app.bundleid</string>
</array>

同时确保Xcode项目中开启了Keychain Sharing功能（在项目target的Signing & Capabilities中添加Keychain Sharing）。

4. 避免误触发登出操作 #

检查代码中是否有在APP生命周期（如dispose、didChangeAppLifecycleState）中误调用FirebaseAuth.instance.signOut()的逻辑，这类操作会主动清除会话。

5. 检查Firebase控制台会话设置 #

登录Firebase控制台，进入Authentication > Settings > Session management，确认"Session expiration"设置为"Never expire"（默认值），如果设置了过期时间，用户会话会在到期后自动登出。

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