Flutter：使用flutter_secure_storage判断登录状态失效问题排查

错误原因 #

你代码里的核心问题是**readSecureData是异步方法，返回的是Future<String>类型**，而非直接的字符串结果。你直接用SecureStorage().readSecureData('keyUserEmail') == 'NULL'做判断时，实际上是把一个Future对象和字符串'NULL'对比，两者类型完全不同，判断结果永远为false，所以代码总是会进入MainPage分支。

解决方案 #

有两种常用修复方式，推荐第一种：

方法1：使用FutureBuilder处理异步逻辑

FutureBuilder是Flutter专门用来处理异步操作、根据状态渲染UI的组件，直接将它作为home的内容即可：

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: context.localizationDelegates,
      supportedLocales: context.supportedLocales,
      locale: context.locale,
      debugShowCheckedModeBanner: false,
      home: FutureBuilder<String>(
        future: SecureStorage().readSecureData('keyUserEmail'),
        builder: (context, snapshot) {
          // 异步操作未完成时，显示加载过渡页面
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Scaffold(body: Center(child: CircularProgressIndicator()));
          }
          // 根据返回值判断跳转页面
          return snapshot.data == 'NULL' ? const Login() : MainPage();
        },
      ),
    );
  }
}

方法2：将MyApp改为StatefulWidget，在初始化时完成异步读取

如果不想用FutureBuilder，可以把无状态组件改成有状态，在initState里执行异步读取，之后更新状态：

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String? _userEmail;

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

  Future<void> _checkLoginStatus() async {
    final storage = SecureStorage();
    String email = await storage.readSecureData('keyUserEmail');
    setState(() {
      _userEmail = email;
    });
  }

  @override
  Widget build(BuildContext context) {
    // 初始化未完成时显示加载页面
    if (_userEmail == null) {
      return const Scaffold(body: Center(child: CircularProgressIndicator()));
    }
    return MaterialApp(
      localizationsDelegates: context.localizationDelegates,
      supportedLocales: context.supportedLocales,
      locale: context.locale,
      debugShowCheckedModeBanner: false,
      home: _userEmail == 'NULL' ? const Login() : MainPage(),
    );
  }
}

额外优化建议 #

可以把SecureStorage改成单例模式，避免每次创建新实例：

class SecureStorage {
  static final SecureStorage _instance = SecureStorage._internal();
  factory SecureStorage() => _instance;
  SecureStorage._internal();

  final FlutterSecureStorage storage = const FlutterSecureStorage();

  // 原有方法保持不变
}

之后调用时直接用SecureStorage().readSecureData(...)即可，确保全局只有一个存储实例。

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