.NET 8升级后Blazored Modal相关异常排查求助

核心问题分析 #

你的问题出在Blazored.Modal 的服务注册和组件层级配置缺失，和.NET版本升级的关联不大，回滚后仍报错是因为配置项已经丢失。

修复步骤 #

1. 确认包版本并重新安装 #

• 卸载现有 Blazored.Modal 包，安装适配.NET 8的最新稳定版：

  Uninstall-Package Blazored.Modal
  Install-Package Blazored.Modal
  

2. 正确注册服务（Program.cs） #

在builder.Services.AddRazorComponents()之后添加Modal服务注册：

builder.Services.AddBlazoredModal();

3. 配置组件层级（App.razor） #

将BlazoredModal组件放在根组件的最外层，确保所有子组件都能获取到级联的IModalService：

<Router AppAssembly="@typeof(App).Assembly">
    <Found Context="routeData">
        <BlazoredModal />
        <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
        <FocusOnNavigate RouteData="@routeData" Selector="h1" />
    </Found>
    <NotFound>
        <PageTitle>Not found</PageTitle>
        <LayoutView Layout="@typeof(MainLayout)">
            <p role="alert">Sorry, there's nothing at this address.</p>
        </LayoutView>
    </NotFound>
</Router>

4. 修复命名空间引用 #

在使用ModalReference的Razor组件顶部添加命名空间：

@using Blazored.Modal
@using Blazored.Modal.Services

5. 验证组件调用方式 #

确保调用Modal的组件通过注入获取IModalService，而非直接实例化：

[Inject]
public IModalService ModalService { get; set; }

// 打开Modal的示例代码
var parameters = new ModalParameters();
parameters.Add("UserId", currentUserId);
var modalReference = ModalService.Show<UserProfileModal>("用户资料", parameters);

关键注意事项 #

• 不要在MainLayout中嵌套BlazoredModal，必须放在Router内部的根层级，否则路由切换时会丢失级联参数。
• 若使用.NET 8的静态渲染模式，需确保BlazoredModal配置了交互式渲染模式（添加@rendermode InteractiveServer或InteractiveWebAssembly）。

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