.NET MAUI中使用DI的TabBar页面配置DataTemplate与服务注册后仍报「缺少默认构造函数」错误

我完全懂你遇到的这个坑——自定义了带构造函数注入的TabBar页面，明明用了ShellContent的ContentTemplate来延迟实例化，结果编译时还是揪着「缺少默认构造函数」不放。这其实是MAUI XAML解析机制和DI结合时的典型问题，我来帮你一步步解决。

问题根源分析 #

虽然你用了DataTemplate，但MAUI的XAML解析器在处理<local:TabBar />元素时，会先做类型合法性检查：它默认会验证类型是否有公开的无参构造函数，哪怕是在DataTemplate内部。再加上你只给TabBar写了带注入参数的构造函数，直接触发了这个错误。另外，你大概率还漏了把TabBar本身注册到DI容器里，就算绕开构造函数检查，DI也没法帮你创建实例。

解决方案分步走 #

步骤1：补全DI服务注册 #

先打开MauiProgram.cs，把TabBar、HomePage、ProfilePage都注册到DI容器里。根据你的使用场景，用AddTransient（每次请求新实例）或者AddSingleton（全局单例，适合TabBar这种全局组件）都可以：

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkit() // 如果你用到了CommunityToolkit
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });

// 核心：注册所有需要注入的页面
builder.Services.AddTransient<HomePage>();
builder.Services.AddTransient<ProfilePage>();
builder.Services.AddTransient<TabBar>(); // 必须把自定义TabBar也注册进去

// 其他服务注册...

var app = builder.Build();
return app;

步骤2：修改AppShell的实例化逻辑 #

直接在XAML里写<local:TabBar />会让XAML解析器尝试自己实例化，我们改用工厂方法让DI来创建实例，绕过XAML的默认构造函数检查：

第一步：给AppShell添加工厂方法

在AppShell.xaml.cs里新增一个静态方法，从MAUI全局服务容器中获取TabBar实例：

namespace StartStudy;

public partial class AppShell : Shell
{
    public AppShell()
    {
        InitializeComponent();
    }

    // 工厂方法：让DI负责创建TabBar并注入依赖
    public static TabBar CreateTabBar()
    {
        return (TabBar)App.Current.Services.GetRequiredService(typeof(TabBar));
    }
}

第二步：修改AppShell.xaml的DataTemplate

把原来的DataTemplate改成调用我们的工厂方法：

<?xml version="1.0" encoding="UTF-8" ?>
<Shell x:Class="StartStudy.AppShell"
       xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
       xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
       xmlns:local="clr-namespace:StartStudy"
       Title="StartStudy"
       Shell.FlyoutBehavior="Disabled">

    <ShellContent Title="Main Tab Bar" Route="MainTabBar">
        <ShellContent.ContentTemplate>
            <!-- 通过工厂方法创建TabBar，绕过默认构造函数检查 -->
            <DataTemplate x:FactoryMethod="CreateTabBar">
                <x:Arguments />
            </DataTemplate>
        </ShellContent.ContentTemplate>
    </ShellContent>

</Shell>

步骤3：验证构造函数权限 #

确认你的TabBar构造函数是public的（你的代码里已经满足了，这步主要是防遗漏），同时HomePage和ProfilePage如果也用了构造函数注入，也要确保它们的依赖都已注册。

额外小提示 #

你的自定义TabBar类名和MAUI内置的TabBar控件重名了，虽然现在在你的命名空间下没问题，但长期来看容易造成代码混淆，建议改成CustomTabBar或者MainTabBar这类更明确的名字。

内容来源于stack exchange