Flutter在iOS后台可靠使用加密数据库的适配问题咨询

一、修复Keychain Accessibility配置问题 #

flutter_secure_storage默认的Keychain访问策略在设备锁定时会限制后台访问，且弃用了always选项。推荐使用苹果官方认可的afterFirstUnlockThisDeviceOnly配置，确保设备首次解锁后，即使后续锁定，后台仍能访问Keychain：

final storage = FlutterSecureStorage(
  iOptions: IOSOptions(
    accessibility: IOSAccessibility.afterFirstUnlockThisDeviceOnly,
  ),
);

该选项既符合苹果安全规范，又能满足后台运行时的密钥读取需求。

二、避免误生成新密钥损坏数据库 #

核心问题是设备锁定时，contains/read返回空值，与"未初始化"状态混淆，导致生成新密钥覆盖原有加密密钥，直接损坏Hive数据库。以下是可行的防护方案：

1. 用本地标记区分状态 #

通过SharedPreferences存储Hive初始化状态，明确区分"首次启动未初始化"和"已初始化但Keychain不可访问"：

final prefs = await SharedPreferences.getInstance();
final hasInitializedHive = prefs.getBool('hive_initialized') ?? false;

final key = await storage.read(key: 'hive_key');
if (key == null) {
  if (hasInitializedHive) {
    // 已初始化但读不到密钥，说明Keychain不可访问（设备锁定），抛出异常或执行等待逻辑
    throw Exception('Keychain inaccessible - device likely locked');
  } else {
    // 首次初始化，生成并存储密钥
    final newKey = Hive.generateSecureKey();
    await storage.write(key: 'hive_key', value: base64Encode(newKey));
    await prefs.setBool('hive_initialized', true);
  }
}

2. 提前验证Keychain可用性 #

在读取密钥前，通过写入并读取测试值验证Keychain是否可正常访问：

Future<bool> isKeychainAccessible() async {
  const testKey = '_keychain_access_test';
  const testValue = 'access_check';
  try {
    await storage.write(key: testKey, value: testValue);
    final readValue = await storage.read(key: testKey);
    await storage.delete(key: testKey);
    return readValue == testValue;
  } catch (_) {
    return false;
  }
}

// 使用示例
if (!await isKeychainAccessible()) {
  // Keychain不可访问，暂停数据库操作，等待设备解锁或应用回到前台
  return;
}
// 继续读取密钥初始化Hive

3. 原生代码判断设备锁定状态 #

由于pub.dev稳定版的flutter_secure_storage没有cupertinoIsProtected功能，可通过MethodChannel调用iOS原生代码直接判断Keychain是否因设备锁定而受保护：

iOS原生Swift代码（添加到项目的Swift文件中）

import UIKit
import LocalAuthentication

@objc class KeychainStatusChecker: NSObject {
    @objc func isDeviceLockedOrKeychainProtected() -> Bool {
        let context = LAContext()
        var error: NSError?
        // 检查设备是否设置了锁屏密码
        guard context.canEvaluatePolicy(.deviceOwnerAuthentication, error: &error) else {
            return false
        }
        // 判断当前设备是否处于锁定状态（通过是否需要验证身份间接判断）
        var isLocked = true
        context.evaluatePolicy(.deviceOwnerAuthentication, localizedReason: "Check lock status") { success, _ in
            isLocked = !success
        }
        return isLocked
    }
}

Flutter端MethodChannel调用

const platform = MethodChannel('com.yourapp/keychain_checker');

Future<bool> isKeychainProtected() async {
    try {
        return await platform.invokeMethod('checkKeychainProtection');
    } on PlatformException catch (_) {
        return false;
    }
}

三、后台运行可靠性补充配置 #

1. 在iOS项目的Info.plist中添加所需的后台模式权限，根据你的应用场景选择（例如下载、通知等）：

<key>UIBackgroundModes</key>
<array>
    <string>fetch</string>
    <string>remote-notification</string>
</array>

2. 后台任务执行时，若检测到Keychain不可访问，将任务加入延迟队列，等待应用恢复前台或设备解锁后再执行，避免强制操作导致数据库损坏。

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