.NET 8 MAUI Blazor Hybrid无法解析clr-namespace:Components.Routes求助

问题原因 #

1. XAML命名空间映射不完整：local仅映射了根命名空间MauiApp1，而Routes组件位于MauiApp1.Components子命名空间下，直接通过local:Components.Routes无法正确解析类型。
2. 编译缓存干扰：即使是默认生成的代码，也可能因编译缓存未更新导致元数据无法识别组件类型。
3. 组件命名空间缺失：若Routes.Razor未正确声明命名空间，也会引发类型解析失败。

解决方法 #

方法1：修正XAML命名空间映射 #

修改MainPage.xaml，添加子命名空间的映射，并更新组件引用：

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:MauiApp1"
             xmlns:components="clr-namespace:MauiApp1.Components"
             x:Class="MauiApp1.MainPage"
             BackgroundColor="{DynamicResource PageBackgroundColor}">

    <BlazorWebView x:Name="blazorWebView" HostPage="wwwroot/index.html">
        <BlazorWebView.RootComponents>
            <RootComponent Selector="#app" ComponentType="{x:Type components:Routes}" />
        </BlazorWebView.RootComponents>
    </BlazorWebView>

</ContentPage>

方法2：清理编译缓存并重编 #

• 右键解决方案，选择清理解决方案
• 右键解决方案，选择生成解决方案
• 或手动删除项目目录下的bin和obj文件夹后重新编译

方法3：确认组件命名空间 #

检查Routes.Razor顶部是否包含正确的命名空间声明，缺失则手动添加：

@namespace MauiApp1.Components

<Router AppAssembly="@typeof(MauiProgram).Assembly">
    <Found Context="routeData">
        <RouteView RouteData="@routeData" DefaultLayout="@typeof(Layout.MainLayout)" />
        <FocusOnNavigate RouteData="@routeData" Selector="h1" />
    </Found>
</Router>

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