MAUI安卓模拟器中SecureStorage无法正常工作问题排查

1. 最可能的原因：调用异步方法未使用await #

你的SaveAsync和GetAsync都是异步方法，若调用时未添加await关键字，方法会在后台异步执行，主线程会直接跳过后续逻辑继续走，看起来就像“执行到对应代码行后直接返回”。

错误调用方式：

StorageHelper.SaveAsync("token", myToken); // 无await，后台执行，主线程直接继续

正确调用方式：

await StorageHelper.SaveAsync("token", myToken); // 等待异步操作完成再继续流程

注意：调用方也必须标记为async方法，比如Button点击事件：

private async void SaveTokenBtn_Clicked(object sender, EventArgs e)
{
    await StorageHelper.SaveAsync("token", "my_auth_token");
}

2. 检查平台特定配置 #

Android #

MAUI SecureStorage默认依赖系统Keystore，若在Android 10（API 29）及以下设备测试，需在Platforms/Android/AndroidManifest.xml中添加存储权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />

另外需确保设备支持硬件加密，无加密的设备可能导致SecureStorage无法正常工作。

iOS #

iOS端SecureStorage基于Keychain，默认无需额外配置，但模拟器偶尔会出现Keychain访问异常，建议切换到真机测试，或重启模拟器后重试。

3. 完善异常日志定位问题 #

你的catch块仅记录异常消息却未输出，导致即使有异常也无法看到具体原因。修改代码添加日志输出：

public static async Task SaveAsync<T>(string key, T data)
{
    try
    {
        if (SecureStorage.Default == null)
        {
            Debug.WriteLine("SecureStorage.Default 未初始化");
            return;
        }
        bool success = SecureStorage.Default.Remove(key);
        var value = JsonSerializer.Serialize(data);
        await SecureStorage.Default.SetAsync(key, value);
        Debug.WriteLine("SaveAsync 执行成功");
    }
    catch (Exception ex)
    {
        Debug.WriteLine($"SaveAsync 错误详情：{ex.ToString()}"); // 输出完整异常栈
        return;
    }
}

public static async Task<T> GetAsync<T>(string key)
{
    try
    {
        if (SecureStorage.Default == null)
        {
            Debug.WriteLine("SecureStorage.Default 未初始化");
            return default;
        }
        var value = await SecureStorage.Default.GetAsync(key);
        Debug.WriteLine($"GetAsync 获取到的值：{value}");

        if (string.IsNullOrWhiteSpace(value))
            return default;

        var data = JsonSerializer.Deserialize<T>(value);
        return data;
    }
    catch (Exception ex)
    {
        Debug.WriteLine($"GetAsync 错误详情：{ex.ToString()}");
        return default;
    }
}

查看Visual Studio的输出窗口日志，即可明确具体问题点。

4. 确认SecureStorage初始化时机 #

确保在MAUI应用初始化完成后调用SecureStorage，比如在页面的OnAppearing方法、App.xaml.cs的OnStart方法之后，避免在应用启动早期（如构造函数）调用，此时SecureStorage可能还未完成初始化。

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