.NET 8 Blazor交互式服务器应用RegisterOnPersisting回调未执行

很多升级到.NET 8的Blazor开发者都遇到过类似问题，核心原因大多和.NET 8对渲染模式、组件生命周期的调整有关，结合你的代码给出几个排查方向：

• 移除RenderMode参数重载
  你注册回调时指定了RenderMode.InteractiveServer，但在预渲染场景下，这个参数会限制回调的触发条件。尝试改用不带RenderMode的重载：

  _subscription = ApplicationState.RegisterOnPersisting(() =>
  {
      ApplicationState.PersistAsJson("TenantData", TenantViewModel);
      ApplicationState.PersistAsJson("TenantGroupData", TenantGroupViewModel);
      ApplicationState.PersistAsJson("FirstLoadTenantViewModel", FirstLoadTenantViewModel);
      return Task.CompletedTask;
  });
  

  预渲染阶段的组件上下文和指定的InteractiveServer模式不匹配，会导致注册的回调被忽略。

• 调整注册时机到同步生命周期方法
  把RegisterOnPersisting的注册逻辑移到OnInitialized同步方法中，避免异步数据加载逻辑影响回调注册时机：

  protected override void OnInitialized()
  {
      base.OnInitialized();
      _subscription = ApplicationState.RegisterOnPersisting(() =>
      {
          ApplicationState.PersistAsJson("TenantData", TenantViewModel);
          ApplicationState.PersistAsJson("TenantGroupData", TenantGroupViewModel);
          ApplicationState.PersistAsJson("FirstLoadTenantViewModel", FirstLoadTenantViewModel);
          return Task.CompletedTask;
      });
  }
  
  protected override async Task OnInitializedAsync()
  {
      await base.OnInitializedAsync();
      // 原有的数据加载逻辑放在这里
  }
  

• 检查预渲染配置与组件标记
  确认Program.cs中渲染模式配置正确：

  app.MapRazorComponents<App>()
      .AddInteractiveServerRenderMode(options =>
      {
          options.PreventOverhang = true;
      });
  

  同时确保组件使用时指定了预渲染模式：

  <component type="typeof(YourTenantComponent)" render-mode="InteractiveServerPrerendered" />
  

  缺少预渲染标记会导致组件只执行一次初始化，不会触发持久化回调。

• 确认PersistentComponentState注入范围
  检查组件层级的注入是否正确，PersistentComponentState是组件级作用域服务，嵌套组件如果存在父组件覆盖注入的情况，也会导致回调无法触发。

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