ASP.NET Core 8中Razor页面传参至Razor组件：引用类型为Null

针对你在ASP.NET Core 8 Razor Pages中调用Razor组件时，值类型参数正常传递但引用类型（Asset、AssetTypes）为Null的问题，可按以下步骤排查解决：

1. 验证引用类型的可序列化性 #

ServerPrerendered模式下，组件预渲染时需要将参数序列化到页面，后续SignalR连接会复用这些参数。如果引用类型无法正常序列化，就会导致参数丢失：

• 检查AssetVm类：确保它有公共无参构造函数，所有需要传递的属性都是公共可读写的；如果存在循环引用或不可序列化的属性（如未实例化的接口类型），需添加[JsonIgnore]标记忽略这些属性，或配置Json序列化选项处理。
• 手动验证序列化：在调用RenderComponentAsync前，添加代码测试序列化是否正常：

  var jsonAsset = System.Text.Json.JsonSerializer.Serialize(asset);
  var jsonAssetTypes = System.Text.Json.JsonSerializer.Serialize(assetTypes);
  

  如果序列化报错，根据错误信息修复类型的序列化问题。

2. 切换渲染模式测试 #

暂时将RenderMode.ServerPrerendered改为RenderMode.Server，跳过预渲染阶段，看参数是否能正常传递：

@(await Html.RenderComponentAsync<Component1>(RenderMode.Server, new { Asset = asset, AssetTypes = assetTypes, Test = 2 }))

如果此模式下参数正常，说明问题出在预渲染的序列化环节，回到第一步解决序列化问题即可。

3. 使用Tag Helper方式引用组件（推荐） #

ASP.NET Core 8支持直接用Tag Helper在Razor Pages中引用组件，这种方式的参数绑定更可靠，避免匿名对象传递的潜在问题：

1. 在_ViewImports.cshtml中添加组件所在程序集的Tag Helper引用：

   @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
   @addTagHelper *, 你的组件所在程序集名称 // 例如：@addTagHelper *, MyWebApp
   

2. 在Razor页面中直接使用组件标签：

   <component type="typeof(Component1)" render-mode="ServerPrerendered" 
              param-Asset="asset" 
              param-AssetTypes="assetTypes" 
              param-Test="2" />
   

4. 检查参数名称与类型匹配 #

确认组件参数名称（Asset、AssetTypes）与调用时匿名对象的属性名完全一致（C#大小写敏感，严格匹配更稳妥）；同时确保传递的asset、assetTypes变量类型与组件参数类型完全兼容（例如AssetVm而非派生类或其他不兼容类型）。

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