Flutter中flutter_secure_storage读为null、热重载数据丢失问题解决

两个核心问题会导致你观察到的异常：

• 读取逻辑的时序错误：在StatelessWidget的构造函数中编写的读取代码，.then回调属于异步执行队列，构造函数的同步代码运行到print(finalEmail)时，异步读取任务根本还没拿到返回值，此时打印的null是变量初始值，并非真的没读到数据。
• 存储配置缺失导致的持久化失效：实例化FlutterSecureStorage时没有配置平台专属参数，Android端默认配置下加密密钥不会持久化到共享偏好中，热重启、调试模式下系统会随机生成新的加密密钥，导致之前写入的内容无法解密、返回null，观感上和数据丢失完全一致。

按步骤修正即可：

• 把闪屏页从StatelessWidget改为StatefulWidget，将存储读取逻辑放到initState对应的异步方法中，等await拿到读取结果后再更新UI、执行路由跳转，绝对不要在构造函数中编写依赖异步返回值的逻辑。
• 实例化FlutterSecureStorage时补全平台配置，开启加密密钥的持久化存储，避免调试、热重启场景下密钥丢失。
• 写入用户信息时，等待writeSecureData的Future执行完成后再触发页面跳转，避免写入任务被系统中断。
• 排查时用readAll()接口打印所有已存储的键值对，确认读取和写入时的key拼写、大小写完全一致，排除拼写错误导致的读取失败。

首先是优化后的SecureStorage封装类：

import 'package:flutter_secure_storage/flutter_secure_storage.dart';

class SecureStorage {
  // 补全平台配置，持久化加密密钥
  final _storage = const FlutterSecureStorage(
    aOptions: AndroidOptions(
      encryptedSharedPreferences: true,
    ),
    iOptions: IOSOptions(
      accessibility: KeychainAccessibility.first_unlock,
    ),
  );

  Future<void> writeSecureData(String key, String value) async {
    await _storage.write(key: key, value: value);
  }

  Future<String?> readSecureData(String key) async {
    return await _storage.read(key: key);
  }

  Future<void> deleteSecureData(String key) async {
    await _storage.delete(key: key);
  }
}

然后是修正后的闪屏页实现：

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

  @override
  State<SplashScreen> createState() => _SplashScreenState();
}

class _SplashScreenState extends State<SplashScreen> {
  final SecureStorage _secureStorage = SecureStorage();
  String? finalEmail;
  String? finalName;

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

  Future<void> _loadStoredInfo() async {
    // 并行读取两个字段，降低等待耗时
    final storedValues = await Future.wait([
      _secureStorage.readSecureData("email"),
      _secureStorage.readSecureData("name"),
    ]);

    if (mounted) {
      setState(() {
        finalEmail = storedValues[0];
        finalName = storedValues[1];
      });
      // 拿到值之后再执行后续业务逻辑，打印结果为真实存储值
      print("读取到的邮箱：$finalEmail");
      print("读取到的姓名：$finalName");
    }
  }

  @override
  Widget build(BuildContext context) {
    // 原有UI逻辑省略
    return const SizedBox();
  }
}

• 热重载本身不会清空SecureStorage的存储内容，如果出现热重载后读不到数据，基本是配置缺失导致的密钥解密失败，并非数据真的被删除。
• 不要在异步任务未完成时就打印变量值验证结果，所有验证逻辑必须放到await或.then的回调块里，否则拿到的永远是初始null值。
• 如果多次调整后还是读取异常，可以先调用deleteAll()清空所有历史存储内容，重新走一次登录写入流程，排除历史加密密钥不匹配的问题。

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