Flutter Secure Storage重启应用后数据无法持久化的问题求助

我在使用FlutterSecureStorage存储用户登录凭证时遇到了一个问题：在应用内切换页面时，数据的存储和读取都正常，但重启应用后所有存储的数据都会丢失。以下是我的相关代码：

数据存储代码 #

usuario = user.textField.text;
clave = pass.textField.text;
await almacenDatos.write(key: "usuario", value: usuario);
await almacenDatos.write(key: "clave", value: clave);

数据读取代码 #

void credenciales() async {
  String? usuario_aux = await almacenDatos.read(key: "usuario");
  String? clave_aux = await almacenDatos.read(key: "clave");
  if(usuario_aux != null){
    usuario = usuario_aux;
  }
  if(clave_aux != null){
    clave = clave_aux;
  }
}

看起来你遇到的是FlutterSecureStorage常见的持久化问题，我帮你梳理几个可能的原因和对应的解决方案：

1. 检查FlutterSecureStorage的实例化方式 #

首先要确保almacenDatos是全局单例或者在应用启动时就完成初始化，而不是在每次使用时都新建实例。比如：

// 在全局位置或者应用入口初始化
final FlutterSecureStorage almacenDatos = FlutterSecureStorage();

虽然理论上多次实例化不会直接导致数据丢失，但某些平台的底层实现可能会因为实例配置不一致（比如自定义存储选项）导致无法读取之前存储的数据。

2. 排查平台特定配置问题 #

FlutterSecureStorage依赖平台原生的安全存储（Android的EncryptedSharedPreferences/iOS的Keychain），平台配置错误会导致持久化失败：

Android端检查 #

• 确保你的Android项目使用的是AndroidX（Flutter新项目默认已经支持），旧的Support Library可能会和EncryptedSharedPreferences不兼容。
• 检查是否在初始化时错误设置了storageOption，比如指定了临时存储：

  // 错误示例：使用临时存储，重启后数据会丢失
  final almacenDatos = FlutterSecureStorage(
    storageOptions: AndroidOptions(
      encryptedSharedPreferences: false,
      sharedPreferencesName: "temp_prefs", // 临时命名空间
    ),
  );
  

  默认配置下encryptedSharedPreferences为true，会使用系统加密的SharedPreferences，持久化是可靠的。

iOS端检查 #

• 如果是在模拟器上测试，尝试切换到真机：模拟器的Keychain有时候会出现数据不持久的问题（比如重启模拟器后数据丢失）。
• 确保Info.plist中配置了必要的权限（如果使用生物识别的话），即使不使用生物识别，也建议添加：

  <key>NSFaceIDUsageDescription</key>
  <string>需要访问钥匙串存储您的登录信息</string>
  

• 检查是否在初始化时设置了错误的Keychain配置，比如指定了accessible属性为临时访问：

  // 错误示例：仅当前会话可访问，重启后丢失
  final almacenDatos = FlutterSecureStorage(
    storageOptions: IOSOptions(
      accessible: IOSAccessible.whenUnlockedThisDeviceOnly,
    ),
  );
  

  默认的accessible值是IOSAccessible.whenUnlocked，可以保证重启后仍可访问。

3. 确认数据读取的时机和逻辑 #

你的credenciales()方法是异步的，需要确保在Widget初始化时正确调用，并且读取完成后更新UI（如果需要）：

@override
void initState() {
  super.initState();
  // 在Widget渲染完成后调用异步读取方法
  WidgetsBinding.instance.addPostFrameCallback((_) {
    _loadCredentials();
  });
}

Future<void> _loadCredentials() async {
  await credenciales();
  // 如果需要更新UI，调用setState
  setState(() {});
}

另外，建议在读取时添加日志，确认是否真的读取不到数据，而不是UI没有更新：

void credenciales() async {
  String? usuario_aux = await almacenDatos.read(key: "usuario");
  String? clave_aux = await almacenDatos.read(key: "clave");
  print("读取到的用户: $usuario_aux");
  print("读取到的密码: $clave_aux");
  if(usuario_aux != null){
    usuario = usuario_aux;
  }
  if(clave_aux != null){
    clave = clave_aux;
  }
}

4. 检查存储操作是否成功 #

在存储数据时添加异常捕获，确认存储过程没有出错：

try {
  await almacenDatos.write(key: "usuario", value: usuario);
  await almacenDatos.write(key: "clave", value: clave);
  print("数据存储成功");
} catch (e) {
  print("存储失败，错误信息: $e");
}

如果存储时抛出异常，比如权限不足或者加密失败，就会导致数据没有被持久化。

5. 更新FlutterSecureStorage版本 #

旧版本的FlutterSecureStorage可能存在已知的持久化bug，建议更新到最新稳定版：
在pubspec.yaml中修改版本号：

dependencies:
  flutter_secure_storage: ^9.0.0 # 替换为最新版本

然后运行flutter pub get更新依赖。

按照以上步骤排查，应该能找到数据丢失的原因。如果还是不行，可以尝试在不同设备（真机）上测试，排除模拟器的问题。

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