.NET 9 Blazor Server中自定义404组件引发RenderFragment<T>序列化错误的解决方法咨询

碰到这个问题确实挺闹心的，我在.NET 9 Blazor Server开发中也遇到过类似的情况，根源在于RenderFragment无法跨渲染模式边界序列化——你直接给<Router>组件加上@rendermode="InteractiveServer"后，Found和NotFound里的模板内容属于带有执行逻辑的代码片段，没办法被序列化传递给交互式渲染的组件实例，所以才抛出了这个InvalidOperationException。

下面给你几个可行的解决思路，按推荐程度排序：

1. 全局配置交互式渲染模式（最推荐） #

把渲染模式的配置从<Router>组件上移到全局，这样<Router>本身保持静态SSR状态，内部的组件会自动应用交互式模式，同时Found和NotFound模板能正常工作。

步骤： #

• 首先移除<Router>标签上的@rendermode="InteractiveServer"属性，恢复Router的默认静态状态：

<Router AppAssembly="@typeof(App).Assembly">
    <Found Context="routeData">
        <RouteView RouteData="@routeData" DefaultLayout="typeof(MainLayout)" />
    </Found>
    <NotFound>
        <LayoutView Layout="typeof(MainLayout)">
            <NotFoundComponent />
        </LayoutView>
    </NotFound>
</Router>

• 然后在Program.cs里全局配置交互式Server渲染模式：

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

app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode();

这样设置后，你的整个应用都会默认使用InteractiveServer渲染模式，同时Router的模板参数不会再触发序列化问题，自定义404组件也能正常显示。

2. 将模板内容封装为独立组件 #

如果一定要给<Router>指定渲染模式，可以把Found和NotFound里的内容封装成独立的组件，避免直接传递RenderFragment：

示例： #

• 创建FoundContent.razor组件：

@inherits ComponentBase
[Parameter] public RouteData RouteData { get; set; }

<RouteView RouteData="@RouteData" DefaultLayout="typeof(MainLayout)" />

• 修改<Router>的代码：

<Router AppAssembly="@typeof(App).Assembly" @rendermode="InteractiveServer">
    <Found Context="routeData">
        <FoundContent RouteData="@routeData" />
    </Found>
    <NotFound>
        <LayoutView Layout="typeof(MainLayout)">
            <NotFoundComponent />
        </LayoutView>
    </NotFound>
</Router>

这种方式通过传递普通参数（而非RenderFragment）来绕开序列化限制，但相比全局配置，会增加一些组件拆分的工作量。

3. 配置全局 fallback 路由 #

你也可以在Program.cs里直接配置全局的404 fallback路由，指向你的自定义404组件：

app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode()
    .AddFallbackRoute("/NotFound");

然后确保你有对应的NotFound.razor组件（或者直接用你的NotFoundComponent），这种方式会让所有未匹配的路由直接跳转到404页面，适合不需要在Router内处理NotFound场景的情况。

补充说明 #

为什么会出现这个错误？在.NET 9的交互式渲染模式中，当组件被标记为InteractiveServer时，它的所有参数需要能被序列化后传递给服务器端的组件实例。而RenderFragment<T>本质上是一段可执行代码，无法被序列化，所以直接给Router加交互式模式就会触发这个异常。

内容来源于stack exchange