Flutter FutureBuilder的Future始终无法完成问题求助

你的代码主要存在三个核心问题，导致Future始终无法完成、一直停留在启动页：

1. Map数据访问方式错误 #

你返回的Future结果是Map<String, dynamic>，但代码里用了对象属性的访问方式snapshot.data.previousUser，这会直接引发语法错误，导致Future执行中断。正确的做法是通过Map的键来取值：snapshot.data?['user']。

2. 未处理Future的异常与连接状态 #

signInSilently()或SharedPreferences操作可能抛出异常（比如权限未配置、网络问题），但你的FutureBuilder只处理了hasData的情况，完全忽略了hasError和connectionState的其他状态，导致异常时Future卡住，一直显示启动页。

3. GoogleSignIn实例未正确初始化 #

如果googleSignIn没有配置必要的权限范围（scopes），静默登录可能失败或卡住，无法正常返回结果。

修改后的完整代码 #

class _MyAppState extends State<MyApp> {
  // 初始化GoogleSignIn并配置必要权限
  final GoogleSignIn googleSignIn = GoogleSignIn(
    scopes: [
      'email',
      'https://www.googleapis.com/auth/drive.file', // Drive文件访问权限
      'https://www.googleapis.com/auth/spreadsheets.readonly', // 表格只读权限
    ],
  );
  Future<Map<String, dynamic>>? _previousAuth;

  @override
  void initState() {
    super.initState();
    _previousAuth = initializeAuth();
  }

  Future<Map<String, dynamic>> initializeAuth() async {
    Map<String, dynamic> data = {};
    try {
      // 捕获静默登录可能出现的异常
      GoogleSignInAccount? previousUser = await googleSignIn.signInSilently();
      final prefs = await SharedPreferences.getInstance();
      String? spreadsheetId = prefs.getString('spreadsheetId');
      String? spreadsheetName = prefs.getString('spreadsheetName');
      data['user'] = previousUser;
      data['spreadsheetId'] = spreadsheetId;
      data['spreadsheetName'] = spreadsheetName;
    } catch (e) {
      // 打印异常信息，方便排查问题
      print('初始化流程出错: $e');
    }
    // 无论是否异常，确保Future能正常返回结果
    return data;
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: FutureBuilder(
        future: _previousAuth,
        builder: (context, snapshot) {
          // 处理异常情况：直接跳转登录页
          if (snapshot.hasError) {
            return LoginPage();
          }
          // 根据连接状态处理UI
          switch (snapshot.connectionState) {
            case ConnectionState.none:
            case ConnectionState.waiting:
              return SplashScreen();
            case ConnectionState.active:
            case ConnectionState.done:
              // 正确通过Map键获取用户数据
              if (snapshot.data?['user'] != null) {
                return HomePage();
              }
              return LoginPage();
          }
        },
      ),
    );
  }
}

关键修改说明 #

1. 添加异常捕获：在initializeAuth中用try-catch包裹异步操作，确保即使出现错误，Future也能正常完成，不会卡住。
2. 修正数据访问：用snapshot.data?['user']替代错误的对象属性访问方式，避免语法错误。
3. 完善状态处理：通过switch明确处理connectionState的所有状态，同时增加hasError的分支，异常时直接跳转登录页。
4. 配置权限范围：初始化GoogleSignIn时添加了Drive和表格的必要权限，确保静默登录能正常获取认证状态。

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