MAUI SecureStorage怎么用 MAUI安全存储使用方法

MAUI的SecureStorage是专为安全保存小段敏感数据设计的跨平台API，适用于token、密码等短字符串，不支持大文件或大量文本；需注意异常处理、平台差异及迁移兼容性。

MAUI 的 SecureStorage 是专为安全保存小段敏感数据（如 token、密码、密钥）设计的跨平台 API，它不是用来存大文件或大量文本的。用对了很省心，用错了容易报错或数据丢失。

基础写入与读取

这是最常用的操作，适用于保存 OAuth 令牌、用户登录态等：

• 写入值：
  await SecureStorage.Default.SetAsync("api_token", "ey...");
• 读取值：
  string token = await SecureStorage.Default.GetAsync("api_token");
  如果没存过，返回 null，不是空字符串
• 删除单个键：
  SecureStorage.Default.Remove("api_token");
• 清空全部（慎用）：
  SecureStorage.Default.RemoveAll();

异常处理必须加

SecureStorage 在某些场景下会直接抛异常，比如：设备不支持加密、系统重置过密钥、旧版数据迁移失败。不能只靠 try-catch，还要有兜底逻辑：

• 每次 GetAsync 后检查是否为 null，再决定走登录流程还是继续使用
• 遇到 InvalidOperationException 或 CryptographicException 时，建议先 Remove 再重试写入
• 不要在启动页强行读取并阻塞 UI，异步加载 + 空值判断更稳妥

注意平台差异和迁移兼容

从 Xamarin.Forms 升级到 MAUI 的老项目要特别小心：

标签： android js json windows app ai ios win microsoft 异步加载 敏感数据 数