.NET 8 Blazor应用中如何启用Razor类库内页面/组件的交互性？

当前方案可行性与交互性问题解决 #

你的模块化拆分思路（业务逻辑/领域模型/UI分离）完全可行，问题出在交互式渲染模式的配置和使用方式上，以下是具体修复步骤：

1. 修正Razor类库（RCL）项目配置 #

确保Configurations.UI的.csproj包含以下配置，放在<PropertyGroup>节点内：

<TargetFramework>net8.0</TargetFramework>
<RazorLangVersion>8.0</RazorLangVersion>
<EnableRazorComponents>true</EnableRazorComponents>
<AddRazorSupportForMvc>false</AddRazorSupportForMvc>

同时，RCL必须引用Microsoft.AspNetCore.Components.Web NuGet包，主应用需引用Microsoft.AspNetCore.Components.Web.Server并添加对Configurations.UI的项目引用。

2. 正确启用交互式渲染模式 #

RCL本身无法独立启用交互式渲染，需在主应用层面配置：

• 全局默认启用：在主应用的_Imports.razor中添加：

  @rendermode InteractiveServer
  

  所有组件（包括RCL内的）会默认使用交互式服务器渲染。
• 指定组件/页面启用：在主应用的路由注册中，添加模块程序集并绑定渲染模式，修改Program.cs：

  app.MapRazorComponents<App>()
     .AddInteractiveServerRenderMode()
     .AddAdditionalAssemblies(typeof(Configurations.UI.Pages.Settings).Assembly);
  

  之后可以在RCL的组件/页面上通过特性指定渲染模式：

  @attribute [RenderModeInteractiveServer]
  

• 包裹式启用：在主应用的路由页中用<Component>标签包裹RCL页面，显式指定渲染模式：

  <Component Type="typeof(Configurations.UI.Pages.Settings)" RenderMode="RenderMode.InteractiveServer" />
  

3. 验证依赖与启动逻辑 #

确保主应用的Program.cs中已添加交互式服务注册：

builder.Services.AddRazorComponents()
   .AddInteractiveServerComponents();

更优模块化构建方式 #

如果想进一步提升模块化灵活性，可以参考以下方案：

1. 自动模块扫描加载 #

避免手动添加模块引用，主应用启动时扫描指定目录（如Modules文件夹）下的所有模块程序集，自动注册路由和组件：

var moduleAssemblies = Directory.GetFiles(AppContext.BaseDirectory, "*.UI.dll")
   .Select(Assembly.LoadFrom);

app.MapRazorComponents<App>()
   .AddInteractiveServerRenderMode()
   .AddAdditionalAssemblies(moduleAssemblies.ToArray());

2. 单RCL模块化封装 #

若模块内各层依赖紧密，可以将BLL、Domain、UI合并为一个RCL项目，通过文件夹区分层级（如/BLL、/Domain、/Pages），简化项目结构的同时保持关注点分离。

3. 利用.NET 8静态Web Assets特性 #

确保RCL的静态资源（CSS、JS）能被主应用正确加载，在RCL的.csproj中添加：

<StaticWebAssetBasePath>_content/Configurations.UI</StaticWebAssetBasePath>

主应用即可通过_content/Configurations.UI/css/styles.css访问模块静态资源。

4. 模块化路由约定 #

给所有模块页面统一添加路由前缀（如/Configurations/{Page}），在RCL页面中通过@page实现：

@page "/Configurations/Settings"

主应用无需额外配置即可自动识别带前缀的路由。

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