第4章 Keychain读取解密数据：SecItemCopyMatching查询、数据完整性校验、解密后Data回传

原理说明：解密读取的生命周期

当App业务层需要消费蓝牙通信的明文数据时，需要从Keychain中取出之前存储的加密密封包（Sealed Box）。存储时的格式约定为：IV（初始向量）+ 密文 + 认证标签。读取流程不仅仅是简单的数据取出，还必须包含严格的完整性校验，以防止数据在存储期间被篡改或损坏，最后调用CryptoKit完成AES-GCM解密并将原始Data回传给调用者。

实现流程

1. 构建查询字典： 设置kSecClass、kSecAttrAccount（唯一标签，与写入时一致）、kSecReturnData = true、kSecMatchLimit = kSecMatchLimitOne。
2. 执行SecItemCopyMatching： 调用系统API，返回CFDataRef类型的加密密封包。
3. 数据完整性校验： 检查密封包长度是否大于IV_LEN（12字节） + TAG_LEN（16字节），防止空数据或截断数据进入解密流程。
4. 拆解密封包： 分别提取前12字节作为IV、后16字节作为认证标签、中间部分作为密文。
5. AES-GCM解密： 使用预先加载的对称密钥，调用CryptoKit的AES.GCM.open(SealedBox)。
6. 回传Data： 将解密成功的原始Data返回给上层业务模块（如蓝牙数据处理中心）。

代码/API调用：核心实现

阶段一：构建查询字典并执行查询

let query: [String: Any] = [
    kSecClass as String: kSecClassGenericPassword,
    kSecAttrAccount as String: "com.securebt.encryptionkey",
    kSecAttrService as String: "com.securebt.bluetooth",
    kSecReturnData as String: true,
    kSecMatchLimit as String: kSecMatchLimitOne
]

var item: CFTypeRef?
let status = SecItemCopyMatching(query as CFDictionary, &item)

guard status == errSecSuccess else {
    print("Keychain查询失败，状态码: \(status)")
    return nil
}
guard let sealedData = item as? Data else {
    print("返回数据格式错误")
    return nil
}

阶段二：数据完整性校验与拆解

let ivLength = 12
let tagLength = 16

guard sealedData.count > ivLength + tagLength else {
    print("完整性校验失败: 密封包长度不足 (\(sealedData.count) bytes)")
    return nil
}

let iv = sealedData.prefix(ivLength)
let tag = sealedData.suffix(tagLength)
let ciphertext = sealedData.dropFirst(ivLength).dropLast(tagLength)

阶段三：AES-GCM解密与回传

do {
    let sealedBox = try AES.GCM.SealedBox(
        nonce: AES.GCM.Nonce(data: iv),
        ciphertext: ciphertext,
        tag: tag
    )
    let decryptedData = try AES.GCM.open(sealedBox, using: symmetricKey)
    return decryptedData
} catch let error {
    print("AES-GCM解密失败: \(error.localizedDescription)")
    throw error
}

调试与常见错误

性能与稳定性优化

• 缓存查询结果： Keychain操作属于进程外调用（依赖securityd），延迟较高。建议在成功解密后将Data缓存到内存字典中，监听UIApplication.didEnterBackgroundNotification清理缓存。
• 后台队列解密： 将SecItemCopyMatching和解密操作派发到串行队列（如com.securebt.crypto.queue），避免阻塞主线程造成UI卡顿。
• 细粒度访问控制： 查询时添加 kSecUseDataProtectionKeychain: true，确保Keychain行为在iOS各个版本上表现一致，并支持设备锁定状态下的数据保护。
• 容错重试： 当连续出现errSecItemNotFound超过阈值（如3次），主动触发蓝牙重配对流程，而非停留在空白状态。