将Blazor Web App迁移到Hybrid启动时类型转换异常求助

问题根源 #

你在Blazor Hybrid环境中错误使用了Blazor Server的组件注册方式，导致注入的RemoteNavigationManager与Hybrid所需的WebViewNavigationManager类型冲突；同时直接移除Server组件注册后，缺少Hybrid环境必需的服务配置和IWebHostEnvironment实例。

正确的服务注册方式 #

在MauiProgram.cs中替换原有注册代码，使用MAUI Blazor专用的服务配置：

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });

// 核心：注册MAUI Blazor WebView服务（自动包含正确的WebViewNavigationManager）
builder.Services.AddMauiBlazorWebView();

// 注册Razor组件，使用WebAssembly交互模式（适配Hybrid环境）
builder.Services.AddRazorComponents()
    .AddInteractiveWebAssemblyComponents();

// 调试环境添加开发者工具支持
#if DEBUG
builder.Services.AddBlazorWebViewDeveloperTools();
#endif

var app = builder.Build();
if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}
app.Run();

解决IWebHostEnvironment缺失异常 #

如果执行上述代码后仍出现该异常，可手动注册适配MAUI环境的IWebHostEnvironment实现：

1. 在项目中添加包装类：

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.FileProviders;

public class MauiWebHostEnvironment : IWebHostEnvironment
{
    private readonly IHostEnvironment _hostEnvironment;

    public MauiWebHostEnvironment(IHostEnvironment hostEnvironment)
    {
        _hostEnvironment = hostEnvironment;
    }

    public string WebRootPath => _hostEnvironment.ContentRootPath;
    public IFileProvider WebRootFileProvider => _hostEnvironment.ContentRootFileProvider;
    public string EnvironmentName 
    { 
        get => _hostEnvironment.EnvironmentName; 
        set => _hostEnvironment.EnvironmentName = value; 
    }
    public string ApplicationName 
    { 
        get => _hostEnvironment.ApplicationName; 
        set => _hostEnvironment.ApplicationName = value; 
    }
    public string ContentRootPath 
    { 
        get => _hostEnvironment.ContentRootPath; 
        set => _hostEnvironment.ContentRootPath = value; 
    }
    public IFileProvider ContentRootFileProvider 
    { 
        get => _hostEnvironment.ContentRootFileProvider; 
        set => _hostEnvironment.ContentRootFileProvider = value; 
    }
}

2. 在MauiProgram.cs的服务注册中添加：

builder.Services.AddSingleton<IWebHostEnvironment>(sp => 
    new MauiWebHostEnvironment(sp.GetRequiredService<IHostEnvironment>()));

验证组件注入 #

组件中保持@inject NavigationManager Navigation的写法即可，此时注入的是Hybrid环境专用的WebViewNavigationManager，不会再出现类型转换异常。

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