Flutter Supabase谷歌认证会话无法持久化问题求助

这种谷歌认证重启后会话丢失的问题我之前帮好几个开发者排查过，大概率是几个常见的配置或代码逻辑疏漏，咱们一步步来定位解决：

1. 先检查Supabase初始化的持久化配置 #

Supabase默认用Hive做会话持久化，但如果没正确初始化Hive或者没在Supabase初始化时指定存储，就会导致会话存不下来。

• 首先确保在main函数里先初始化Hive，再初始化Supabase：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    // 初始化Hive本地存储
    await Hive.initFlutter();
    // 初始化Supabase时显式指定Hive作为存储
    await Supabase.initialize(
      url: '你的Supabase实例URL',
      anonKey: '你的Supabase匿名密钥',
      storage: HiveLocalStorage(), // 这行是持久化的关键，别漏了
    );
    // 等待初始会话恢复完成，避免直接判断currentUser为空
    await supabase.auth.initialSession;
    runApp(const MyApp());
  }
  

• 如果Hive一直出问题，可以换用更稳定的SharedPreferencesLocalStorage试试：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    final prefs = await SharedPreferences.getInstance();
    await Supabase.initialize(
      url: '你的Supabase实例URL',
      anonKey: '你的Supabase匿名密钥',
      storage: SharedPreferencesLocalStorage(prefs),
    );
    await supabase.auth.initialSession;
    runApp(const MyApp());
  }
  

2. 确认谷歌登录时的持久化参数 #

有时候可能不小心把persistSession设为了false，导致会话不会被保存。显式设置这个参数为true（默认是true，但显式写出更保险）：

await supabase.auth.signInWithOAuth(
  Provider.google,
  persistSession: true, // 强制开启会话持久化
);

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

• Android端：
  • 检查AndroidManifest.xml是否添加了基础网络权限：

    <uses-permission android:name="android.permission.INTERNET" />
    

  • 部分国产ROM的“应用自动清理”功能会删除应用缓存文件，导致Hive存储的会话丢失，可以测试在系统设置里关闭该应用的“自动清理”权限。
• iOS端：
  • 检查Info.plist是否添加了谷歌OAuth对应的URL Scheme（即你在谷歌云控制台配置的com.googleusercontent.apps.XXXXXX格式的Scheme）：

    <key>LSApplicationQueriesSchemes</key>
    <array>
      <string>com.googleusercontent.apps.你的谷歌客户端ID后缀</string>
    </array>
    

  • 确保开启了Keychain访问权限：在Xcode的Signing & Capabilities面板中添加Keychain Sharing能力，避免会话存储被系统限制。

4. 修正会话状态的监听逻辑 #

很多开发者会在App启动时直接判断supabase.auth.currentUser，但初始会话恢复是异步操作，此时currentUser可能还未被赋值，导致误判用户未登录。正确的做法是监听onAuthStateChange的initialSession事件：

@override
void initState() {
  super.initState();
  _setupAuthListener();
}

void _setupAuthListener() {
  supabase.auth.onAuthStateChange.listen((data) {
    final event = data.event;
    final session = data.session;
    if (event == AuthChangeEvent.initialSession) {
      // 初始会话恢复完成，在这里处理页面跳转逻辑
      if (session != null) {
        Navigator.pushReplacementNamed(context, '/home');
      } else {
        Navigator.pushReplacementNamed(context, '/login');
      }
    }
  });
}

如果按照上面的步骤排查后还是没解决，可以把你的Supabase初始化代码、谷歌登录代码，以及平台配置的细节贴出来，我再帮你精准定位问题~

内容来源于stack exchange