WPF应用BlazorWebView注入NavigationManager报未初始化异常咨询

问题现象 #

• 运行环境：WPF 应用集成 BlazorWebView 控件
• 触发条件：将 NavigationManager 注入自定义服务类后，访问其成员或绑定事件时抛出异常
• 异常详情：

System.InvalidOperationException: ''WebViewNavigationManager' has not been initialized.'

• 对照验证：
  • 同一段代码在浏览器托管的 Blazor WebAssembly 环境下运行正常
  • 将 NavigationManager 直接注入 Razor 组件使用时无任何问题

根本原因 #

这个使用场景是完全受支持的，异常来自初始化时机差异：
Blazor WebAssembly 环境下，NavigationManager 会在服务容器构建阶段、应用正式启动前完成全部初始化；但 WPF/WinForms/MAUI 等桌面端 BlazorWebView 宿主中，WebViewNavigationManager 必须等 BlazorWebView 控件完成加载、和底层 WebView 内核建立通信链路后才会初始化完成。
如果自定义服务在构造函数中直接访问 NavigationManager 成员、绑定事件，由于服务实例通常在容器构建阶段就被创建，这个时间点早于 NavigationManager 的初始化时机，就会触发未初始化异常。而 Razor 组件的实例创建时机在 Blazor 渲染管线启动、NavigationManager 初始化完成之后，所以注入组件使用不会出问题。

修复方案 #

核心原则是不要在服务构造函数阶段直接操作 NavigationManager，两种常用实现：

• 延迟初始化服务
  把 NavigationManager 的事件绑定、成员访问逻辑放到独立的初始化方法中，等 Blazor 应用完全启动后再调用这个方法。
  示例实现：

  public class AppNavigationService
  {
      private readonly NavigationManager _navigationManager;
      private bool _isInitialized = false;
  
      public AppNavigationService(NavigationManager navigationManager)
      {
          _navigationManager = navigationManager;
      }
  
      public void Initialize()
      {
          if (_isInitialized) return;
          // 此时NavigationManager已经完成初始化，操作不会触发异常
          _navigationManager.LocationChanged += OnLocationChanged;
          _isInitialized = true;
      }
  
      private void OnLocationChanged(object? sender, LocationChangedEventArgs e)
      {
          // 自定义导航事件处理逻辑
      }
  }
  

  在根组件 App.razor 中，于首次渲染完成后调用初始化方法：

  @inject AppNavigationService NavigationService
  
  <!-- 原有路由、布局等组件内容 -->
  
  @code {
      protected override void OnAfterRender(bool firstRender)
      {
          if (firstRender)
          {
              NavigationService.Initialize();
          }
      }
  }
  

• 按需延迟解析
  如果服务逻辑不需要在应用启动时就绑定事件，可以在实际需要使用 NavigationManager 的方法中再从服务容器解析实例，只要方法调用时机在 BlazorWebView 加载完成之后就不会触发异常。

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