Blazor Wasm升级至.NET 7后ClaimsIdentity序列化部署异常排查

问题根源 #

本地调试正常但部署报错，核心是Blazor WASM发布时的Linker代码裁剪机制导致的差异：

• 本地调试默认关闭Linker，ClaimsIdentity的所有公共成员（包括Label属性）都完整保留；
• 发布部署时Linker会自动裁剪未被业务代码直接引用的成员，Label属性因未被直接调用被移除，仅留下私有_label字段，但protobuf.net的元类型配置仍在尝试绑定公共Label属性，最终触发启动报错。

排查修复步骤 #

1. 确认Linker配置
   打开项目发布配置文件（Properties/PublishProfiles/[你的发布配置名].pubxml），检查是否存在<BlazorWebAssemblyEnableLinking>true</BlazorWebAssemblyEnableLinking>——这是.NET7 Blazor WASM发布的默认配置，正是它在执行代码裁剪。

2. 让Linker保留Label属性
   在项目根目录新建linker.xml文件，内容如下：

   <?xml version="1.0" encoding="utf-8" ?>
   <linker>
     <assembly fullname="System.Security.Claims">
       <type fullname="System.Security.Claims.ClaimsIdentity">
         <property name="Label" />
       </type>
     </assembly>
   </linker>
   

   随后在项目的.csproj文件中添加该配置的引用：

   <ItemGroup>
     <BlazorLinkerDescriptor Include="linker.xml" />
   </ItemGroup>
   

   这样发布时Linker就会保留Label属性，protobuf.net能正常找到对应字段。

3. 直接绑定私有字段（替代方案）
   若不想修改Linker配置，可直接调整protobuf.net的元类型映射，绑定私有_label字段：

   RuntimeTypeModel.Default.Add(typeof(ClaimsIdentity), false)
     .AddField(1, "_label");
   

4. 清理部署环境缓存
   发布前先在本地执行dotnet publish，用ILSpy检查生成的DLL结构是否与服务器部署版一致；部署时清空服务器目标目录的旧文件，确保完全替换为新发布的文件，避免旧DLL残留导致版本冲突。

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