ASP.NET Blazor 中 NavigationManager 作用域问题的技术解析

背景介绍

在 ASP.NET Blazor WebAssembly 项目中，开发者经常需要使用 NavigationManager 来获取当前应用的导航状态和基础 URI。然而，在 .NET 9 中，一些开发者发现原本在 .NET 8 中可以正常工作的 NavigationManager 解析方式突然出现了问题。

问题现象

当开发者尝试在 HttpClient 配置中通过服务提供程序解析 NavigationManager 时，系统会抛出"无法从根提供程序解析作用域服务"的异常。这种情况通常发生在以下场景：

builder.Services.AddHttpClient("WebApiClient", (serviceProvider, client) => {
    var navigationManager = serviceProvider.GetRequiredService<NavigationManager>();
    client.BaseAddress = new Uri(navigationManager.BaseUri);
});

然而，直接在 Razor 页面中通过构造函数注入 NavigationManager 却可以正常工作。

技术原理

这个问题本质上涉及 .NET 依赖注入系统中服务作用域的生命周期管理：

1. 服务作用域：NavigationManager 被注册为作用域(Scoped)服务，意味着它的生命周期与当前用户会话或组件实例相关联。

2. HttpClientFactory 的特殊性：HttpClientFactory 在创建 HttpClient 时会建立自己的服务作用域，这个作用域与 Blazor 组件的作用域是分离的。

3. 作用域隔离：在 .NET 9 中，服务作用域的管理变得更加严格，不允许跨作用域解析服务，特别是不能从根容器解析作用域服务。

解决方案

针对这个问题，开发者可以采用以下几种解决方案：

1. 直接注入基础地址： 如果基础地址是固定的，可以直接在配置中注入：

   builder.Services.AddHttpClient("WebApiClient", client => {
       client.BaseAddress = new Uri("https://api.example.com");
   });
   

2. 使用 IConfiguration： 通过配置系统获取基础地址：

   builder.Services.AddHttpClient("WebApiClient", (serviceProvider, client) => {
       var configuration = serviceProvider.GetRequiredService<IConfiguration>();
       client.BaseAddress = new Uri(configuration["ApiBaseUrl"]);
   });
   

3. 延迟解析： 在需要时通过组件上下文获取 NavigationManager：

   public class MyService {
       private readonly NavigationManager _navigationManager;
       
       public MyService(NavigationManager navigationManager) {
           _navigationManager = navigationManager;
       }
       
       public void ConfigureClient(HttpClient client) {
           client.BaseAddress = new Uri(_navigationManager.BaseUri);
       }
   }
   

最佳实践建议

1. 尽量避免在 HttpClient 配置中直接解析复杂依赖
2. 对于 Blazor WASM 应用，考虑将配置信息提前加载
3. 使用专门的配置服务来封装这类依赖关系
4. 在应用启动阶段完成所有必要的服务配置

总结

这个问题反映了 .NET 依赖注入系统在版本演进中对作用域管理的加强。开发者需要理解不同服务生命周期的影响，并采用更加规范的依赖注入模式。虽然这可能导致一些现有代码需要调整，但从长远来看，这种严格性有助于构建更加健壮和可维护的应用程序。

对于 Blazor 开发者来说，理解服务作用域和生命周期是掌握框架的重要一环，特别是在处理 HttpClient 和导航相关功能时，需要特别注意这些细节。