Flutter应用Google Sign In弹窗无响应问题求助

排查方向 #

• 设备系统兼容性：统计反馈用户的设备型号、Android/iOS版本，旧版本系统（如Android 7.0以下、iOS 13.x）的WebView组件可能存在兼容性问题，导致Google Sign In弹窗交互失效。
• 网络环境限制：部分用户处于企业内网、特殊地区网络时，Google账户验证请求被拦截，引发弹窗无响应。可引导用户切换网络重试，同时在应用中增加网络状态检测并给出提示。
• Google服务版本：Android端依赖Google Play Services，iOS依赖配套系统服务，设备上服务版本过旧会导致交互异常。建议在应用启动时检测服务版本，提示用户更新。
• 签名与配置问题：检查Google Cloud Console中是否正确添加了Android的SHA-1/SHA-256签名（含debug和release版本）；iOS的REVERSED_CLIENT_ID是否正确配置在Info.plist中，签名不匹配会导致验证流程静默失败。

代码优化与解决方案 #

• 全局单例化GoogleSignIn实例：避免每次登录都新建实例引发状态不一致：

  final GoogleSignIn _googleSignIn = GoogleSignIn(scopes: ['email']);
  
  Future<void> signInWithGoogle() async {
    try {
      final GoogleSignInAccount? account = await _googleSignIn.signIn();
      if (account == null) {
        // 记录用户取消操作的日志
        print('Google Sign In canceled by user');
        return;
      }
      // 后续登录成功逻辑
    } catch (e) {
      // 捕获所有异常并上报至Crashlytics
      FirebaseCrashlytics.instance.recordError(e, StackTrace.current);
      print('Google Sign In error: $e');
    }
  }
  

• 添加超时与交互反馈：防止请求挂起，同时给用户明确的加载状态：

  Future<void> signInWithGoogle() async {
    bool isLoading = true;
    // 切换按钮状态或显示loading弹窗
    try {
      final GoogleSignInAccount? account = await _googleSignIn.signIn().timeout(
        const Duration(seconds: 30),
        onTimeout: () {
          isLoading = false;
          throw TimeoutException('Google Sign In timed out');
        },
      );
      // 处理登录结果
    } on TimeoutException catch (e) {
      FirebaseCrashlytics.instance.recordError(e, StackTrace.current);
      // 提示用户超时，请重试
    } catch (e) {
      FirebaseCrashlytics.instance.recordError(e, StackTrace.current);
      // 通用错误提示
    } finally {
      isLoading = false;
      // 恢复按钮状态或隐藏loading弹窗
    }
  }
  

• Android端WebView配置优化：在AndroidManifest.xml中补充相关配置：

  <application ...>
    <meta-data
        android:name="com.google.android.gms.version"
        android:value="@integer/google_play_services_version" />
    <activity
        android:name="com.google.android.gms.auth.api.signin.internal.SignInHubActivity"
        android:theme="@android:style/Theme.Translucent.NoTitleBar" />
  </application>
  

• iOS端配置补充：确保Info.plist中添加以下配置，避免弹窗被系统拦截：

  <key>LSApplicationQueriesSchemes</key>
  <array>
      <string>googlechrome</string>
      <string>googlechrome-x-callback</string>
  </array>
  <key>NSAppTransportSecurity</key>
  <dict>
      <key>NSAllowsArbitraryLoads</key>
      <false/>
      <key>NSExceptionDomains</key>
      <dict>
          <key>google.com</key>
          <dict>
              <key>NSIncludesSubdomains</key>
              <true/>
              <key>NSAllowsArbitraryLoads</key>
              <true/>
          </dict>
      </dict>
  </dict>
  

日志与上报增强 #

• 除Crashlytics外，添加自定义日志，记录登录流程关键节点（如调用signIn()、弹窗加载、用户点击账户、返回结果等），同时带上设备型号、系统版本、网络状态等信息，便于后续分析。
• 给用户提供反馈入口，引导无响应问题用户导出应用日志，帮助定位根因。

内容的提问来源于stack exchange，提问作者Marcin Szałek