预渲染Blazor WebAssembly无法引用共享库类的问题求助

核心问题 #

你的Blazor WebAssembly客户端无法找到共享类库中的myawesomeclass类型，原因是共享类库的程序集没有被打包到Blazor WASM的客户端部署文件中，浏览器端运行时无法加载该类型，导致参数反序列化失败。此外，报错中的命名空间myaweomenamespace疑似拼写错误（与类库名myawesomelibrary不匹配），也可能是诱因之一。

解决方案 #

1. 确认共享类库的目标框架兼容性 #

共享类库必须设置为Blazor WASM支持的目标框架：

• 打开共享类库的项目属性，将目标框架设置为.NET Standard 2.1或.NET 7（避免使用仅服务器端的框架，如.NET 7 Windows）。

2. 确保Blazor WASM项目正确引用共享类库 #

• 使用项目引用而非手动添加DLL：右键Blazor项目 → 添加 → 项目引用，选择共享类库。
• 检查Blazor项目的.csproj文件，确认存在以下配置：

  <ItemGroup>
    <ProjectReference Include="..\MyAwesomeLibrary\MyAwesomeLibrary.csproj" />
  </ItemGroup>
  

  这样构建时会自动将共享类库的程序集打包到WASM客户端资源中。

3. 修正参数传递的拼写与类型匹配 #

• 检查Razor Pages中传递参数的代码，确保参数名、命名空间、类名完全正确：

  <!-- 示例：Razor Pages中嵌入Blazor组件 -->
  <component 
    type="typeof(YourBlazorProject.Pages.TargetComponent)" 
    render-mode="WebAssemblyPrerendered" 
    param-MyAwesomeParameter="@Model.MyClassInstance" />
  

  注意：param-后的名称需与Blazor组件的参数属性名一致，且类型必须是myawesomenamespace.myawesomeclass（修正报错中疑似拼写错误的myaweomenamespace）。

4. 配置Blazor的序列化选项（可选，针对复杂类型） #

如果myawesomeclass是复杂对象，在Blazor的Program.cs中配置Json序列化，确保能正确处理该类型：

var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.RootComponents.Add<App>("#app");

// 配置HttpClient与Json序列化
builder.Services.AddScoped(sp => new HttpClient { BaseAddress = new Uri(builder.HostEnvironment.BaseAddress) });
builder.Services.AddControllers().AddJsonOptions(options =>
{
    options.JsonSerializerOptions.PropertyNameCaseInsensitive = true;
    options.JsonSerializerOptions.IncludeFields = true;
    // 若有枚举或自定义类型，可添加对应转换器
    // options.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
});

await builder.Build().RunAsync();

5. 清理重建项目 #

• 右键解决方案 → 清理
• 删除所有项目的bin和obj文件夹
• 重新构建并发布解决方案，确保共享类库的程序集被包含在Blazor WASM的输出中。

为什么移模型到Blazor项目会导致Razor Pages无法访问？ #

Blazor WASM项目是客户端应用程序类型，默认输出为浏览器可执行的WASM资源，服务器端的Razor Pages项目无法直接访问Blazor项目中的类（除非将Blazor项目改为类库类型，但这会破坏WASM的运行逻辑）。因此，使用独立的共享类库是唯一能让两端同时访问模型的正确方案。

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