iOS 17.5更新后Flutter应用出现PlatformException(-25300)密钥链错误

核心原因 #

iOS 17.5对Keychain的查询规则、权限校验做了更严格的调整，旧代码中参数不匹配、权限不一致或旧数据兼容性问题，会触发-25300（指定项未找到）错误。

修复步骤 #

1. 严格校验查询参数一致性 #

确保查询Keychain时使用的service、account、accessGroup（若使用）参数与存储时完全一致，包括大小写、特殊字符和空格。比如存储时用"MyAppService"，查询时不能写成"myappservice"。

2. 对齐Keychain访问权限 #

查询时显式指定与存储时一致的kSecAttrAccessible属性，避免权限不匹配导致的查询失败：

import 'package:flutter/services.dart';

Future<String?> getKeychainValue() async {
  const service = "your_app_service";
  const account = "user_settings";
  
  final Map<String, dynamic> query = {
    'kSecClass': 'kSecClassGenericPassword',
    'kSecAttrService': service,
    'kSecAttrAccount': account,
    'kSecAttrAccessible': 'kSecAttrAccessibleWhenUnlocked', // 与存储时权限一致
    'kSecReturnData': true,
  };

  try {
    final result = await MethodChannel('plugins.flutter.io/keychain').invokeMethod('get', query);
    return String.fromCharCodes(result as List<int>);
  } on PlatformException catch (e) {
    if (e.code == "-25300") {
      // 处理项不存在的逻辑
      return null;
    }
    rethrow;
  }
}

3. 清理旧Keychain数据 #

系统更新后旧数据可能出现兼容性问题，可通过以下方式清理：

• 模拟器：卸载应用后，执行Hardware > Erase All Content and Settings
• 真机：卸载应用，重启设备后重新安装

4. 主动捕获异常并降级处理 #

在代码中针对-25300错误做专门处理，避免崩溃并引导用户恢复：

try {
  await checkAgreementIntroScreen(); // 你的业务代码
} on PlatformException catch (e) {
  if (e.code == "-25300") {
    // 比如重置用户协议状态，引导重新确认
    await resetAgreementStatus();
  }
}

5. 更新第三方Keychain插件 #

如果使用flutter_keychain、keychain_access等第三方插件，检查插件版本是否支持iOS 17.5，及时更新到最新适配版本。

6. 验证Entitlements配置 #

检查ios/Runner/Runner.entitlements文件中的keychain-access-groups配置，确保与开发者账号中的配置一致，无拼写错误：

<key>keychain-access-groups</key>
<array>
  <string>$(AppIdentifierPrefix)com.yourcompany.yourapp</string>
</array>

内容的提问来源于stack exchange，提问作者Umut Aktaş