发布新版本后无法从ProtectedLocalStorage加载数据

API 探路者

2026-8-11

问题解答

你的理解完全正确：

ProtectedLocalStorage 确实依赖ASP.NET Core的**数据保护API（Data Protection API）**对本地存储的数据进行加密，加密密钥由该API管理。
默认情况下，Blazor Server应用的数据保护密钥会存储在应用部署目录的本地文件系统或内存中。当你发布新版本时，旧的部署目录会被替换，密钥随之丢失，导致旧版本加密的数据无法被新版本解密，表现为加载时无法解析对象，直接查看本地存储内容会显示乱码。

解决办法：持久化数据保护密钥

要避免新版本发布后密钥丢失，你需要配置数据保护API将密钥存储到一个持久化、跨版本共享的位置，同时固定应用名称来确保密钥容器的一致性。以下是常见的配置方式：

1. 存储到本地固定路径（单服务器部署）

在Program.cs中添加数据保护的配置，指定密钥存储的固定目录：

builder.Services.AddDataProtection()
    // 指定密钥存储的持久化目录（需确保应用有读写权限）
    .PersistKeysToFileSystem(new DirectoryInfo(@"D:\BlazorAppKeys"))
    // 固定应用名称，确保不同版本应用使用同一个密钥容器
    .SetApplicationName("YourBlazorServerApp");

2. 存储到分布式存储（多服务器/云部署）

如果是多服务器部署或云环境，可以将密钥存储到分布式存储中，比如Azure Blob存储、Redis或数据库：

// 示例：存储到Azure Blob存储
builder.Services.AddDataProtection()
    .PersistKeysToAzureBlobStorage(new Uri("https://youraccount.blob.core.windows.net/keys/your-key-container"))
    .SetApplicationName("YourBlazorServerApp");