Blazor Server端OAuth重定向后ProtectedLocalStorage数据丢失求助

可能的原因 #

1. 同源策略限制 #

浏览器的sessionStorage和localStorage遵循严格的同源规则，协议、域名、端口三者必须完全一致才能访问同一存储数据。如果OAuth重定向回调的URL（页面3）和之前的向导页面（1/2）存在差异（比如本地开发时一个用http://localhost:5000，一个用http://localhost:5001），就会导致存储数据无法访问。

2. ProtectedStorage加密密钥不一致 #

Blazor的ProtectedSessionStorage/ProtectedLocalStorage依赖服务器端的DataProtection服务加密数据：

• 如果是Blazor Server，默认使用临时内存密钥，服务器重启或多实例部署时，密钥会变化，导致之前加密的数据无法解密，返回空值。
• 即使是Blazor WebAssembly，若客户端加密上下文因某些原因重置（比如浏览器缓存清除），也可能出现解密失败。

3. OAuth重定向导致会话/存储被清除 #

部分OAuth服务的重定向流程可能触发浏览器的会话重置，或者第三方页面的脚本无意中清除了存储数据（概率较低，但需排查）。

解决方案与排查步骤 #

1. 验证同源一致性 #

• 打开浏览器开发者工具（F12），切换到Application标签：
  • 在页面2加载完成后，检查Session Storage/Local Storage中是否存在目标键（Protected存储的键名会带有Microsoft.AspNetCore.Components.ProtectedStorage.前缀）。
  • 重定向到页面3后，再次检查存储内容：
    • 如果键完全消失，说明URL同源不一致，需调整OAuth回调地址与向导页面保持完全一致。
    • 如果键存在但获取为空，说明加密解密失败。

2. 持久化DataProtection密钥（Blazor Server） #

修改Program.cs，配置DataProtection服务将密钥持久化到稳定存储（如文件系统），确保服务器重启或多实例时密钥一致：

builder.Services.AddDataProtection()
    .PersistKeysToFileSystem(new DirectoryInfo(@"C:\your-key-path")) // 替换为实际路径
    .SetApplicationName("YourWizardApplication") // 固定应用名称，避免密钥隔离
    .SetDefaultKeyLifetime(TimeSpan.FromDays(365)); // 设置密钥有效期

3. 临时改用普通存储验证 #

暂时使用非加密的SessionStorage测试，排除加密问题：

// 页面1存储数据
await SessionStorage.SetAsync("LockExternalRef", userInputValue);

// 页面2/3获取数据
protected override async Task OnAfterRenderAsync(bool firstRender)
{
    if (firstRender)
    {
        var result = await SessionStorage.GetAsync<string>("LockExternalRef");
        Console.WriteLine(result.Value);
        await base.OnAfterRenderAsync(firstRender);
    }
}

如果普通存储能正常获取数据，说明问题出在ProtectedStorage的加密环节。

4. 通过OAuth state参数传递状态 #

如果以上方法都无法解决，可以利用OAuth协议的state参数传递状态：

• 在页面2跳转OAuth服务时，将LockExternalRef的值加密后放入state参数。
• 页面3收到回调时，从URL的state参数中提取并解密，恢复状态数据。

注意：state参数通过URL传递，不要存放敏感数据，必须加密后再传输。

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