.NET MAUI Blazor Hybrid插件系统：如何让Blazor使用新ServiceProvider

核心问题根源 #

BlazorWebView在初始化时会绑定默认的MAUI服务容器，后续组件的服务注入都依赖这个容器实例。你单独维护的ServiceLocator和新ServiceProvider没有和Blazor的渲染器关联，导致组件依然从默认容器解析服务。

具体解决方案 #

1. 确保插件服务的正确注册 #

在PluginInstaller构建新服务集合时，必须基于原有MAUI服务集合扩展，同时正确注册插件类型：

public class PluginInstaller
{
    public static ServiceProvider BuildPluginServiceProvider(IServiceCollection originalServices)
    {
        // 复制原有服务集合，避免修改原容器
        var pluginServices = new ServiceCollection();
        foreach (var service in originalServices)
        {
            pluginServices.Add(service);
        }

        // 注册插件：必须绑定到Plugin接口，才能被Enumerable<Plugin>解析
        pluginServices.AddTransient<Plugin, SamplePlugin1>();
        pluginServices.AddTransient<Plugin, SamplePlugin2>();

        // 注册自定义ServiceLocator到新容器
        pluginServices.AddSingleton<ServiceLocator>(sp => new ServiceLocator(sp));

        return pluginServices.BuildServiceProvider();
    }
}

2. 替换BlazorWebView的服务容器 #

BlazorWebView的Services属性决定了Blazor组件使用的服务提供器，必须在Blazor渲染器初始化前替换它：

方式一：在MainPage初始化时替换

打开MainPage.xaml.cs，在构造函数中获取BlazorWebView实例并替换Services：

public MainPage()
{
    InitializeComponent();

    // 获取MAUI原有服务集合
    var originalServices = MauiProgram.CreateMauiApp().Services;
    // 构建带插件的新服务提供器
    var pluginServiceProvider = PluginInstaller.BuildPluginServiceProvider(originalServices);

    // 替换BlazorWebView的服务容器（blazorWebView是XAML中控件的x:Name）
    blazorWebView.Services = pluginServiceProvider;
}

方式二：在MauiProgram中全局配置

如果需要全局替换，可以在创建BlazorHost时指定自定义服务提供器：

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

    // 注册MAUI基础服务
    builder.Services.AddMauiBlazorWebView();
#if DEBUG
    builder.Services.AddBlazorWebViewDeveloperTools();
#endif

    // 构建插件服务提供器并替换全局服务实例
    var pluginServiceProvider = PluginInstaller.BuildPluginServiceProvider(builder.Services);
    builder.Services.AddSingleton<IServiceProvider>(pluginServiceProvider);

    return builder.Build();
}

3. 验证组件注入的正确性 #

在Blazor组件中直接注入IEnumerable<Plugin>即可获取所有注册的插件：

@inject IEnumerable<Plugin> Plugins

<h3>已加载插件：@Plugins.Count()</h3>
@foreach (var plugin in Plugins)
{
    <p>@plugin.Name</p>
}

关键注意事项 #

• 不要直接修改MAUI的默认服务集合，而是基于它创建新集合扩展，避免破坏MAUI自身的服务依赖。
• 必须确保BlazorWebView的Services属性在渲染器启动前被替换，否则组件会使用已初始化的默认容器。
• 插件注册时必须绑定到Plugin接口，否则IEnumerable<Plugin>无法解析到实现类。

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