Flutter非异步场景下如何从SharedPreferences取值判断加载Widget

问题本质 #

你遇到的错误核心是同步的build方法无法直接等待异步操作结果，且MaterialApp的home参数仅接受Widget类型，不接受Future，两种可行的实现方案如下：

方案1：使用FutureBuilder处理异步加载（代码改动最小） #

FutureBuilder是Flutter官方提供的专门用于在组件树中处理异步操作的组件，直接将它作为home参数的值，它会自动监听异步任务的执行状态，根据不同状态返回对应组件即可：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'KHS Plan',
      theme: ThemeData(
        textTheme: const TextTheme(
          bodyText1: TextStyle(fontSize: 14)
        )
      ),
      home: FutureBuilder<bool>(
        // 传入读取配置的异步方法
        future: getloginbool(),
        builder: (context, snapshot) {
          // 加载过程中显示启动占位页（可替换为自定义闪屏页）
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Scaffold(body: Center(child: CircularProgressIndicator()));
          }
          // 异常状态 fallback 逻辑
          if (snapshot.hasError) {
            return const MyHomePage();
          }
          // 拿到结果后判断跳转目标页
          final bool saveLogin = snapshot.data ?? false;
          return saveLogin ? const Login() : const MyHomePage();
        },
      ),
    );
  }
}

该方案无需修改现有getloginbool、setloginbool方法，也不需要引入额外状态管理逻辑。

方案2：入口提前初始化，同步读取配置值 #

Flutter的main函数支持声明为async，你可以在应用启动渲染前就完成SharedPreferences的初始化和配置读取，后续使用时直接拿同步值即可，体验更流畅：

void main() async {
  // 必须添加该行，确保异步操作完成后再渲染界面
  WidgetsFlutterBinding.ensureInitialized();
  // 提前完成配置读取
  SharedPreferences prefs = await SharedPreferences.getInstance();
  final bool saveLogin = prefs.getBool("savelogin") ?? false;
  // 将同步值传入应用根组件
  runApp(MyApp(saveLogin: saveLogin));
}

class MyApp extends StatelessWidget {
  final bool saveLogin;
  const MyApp({super.key, required this.saveLogin});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'KHS Plan',
      theme: ThemeData(
        textTheme: const TextTheme(
          bodyText1: TextStyle(fontSize: 14)
        )
      ),
      // 直接用同步值判断首页，无异步等待过程
      home: saveLogin ? const Login() : const MyHomePage(),
    );
  }
}

该方案没有异步加载的等待间隙，启动后直接渲染目标页面，适合对首屏加载速度要求高的场景。

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