MAUI Blazor Hybrid Windows启动模板无法加载问题求助
以下是针对未修改代码的全新模板项目出现该问题的具体排查步骤:
确认项目启动配置与目标框架
检查Visual Studio中MAUI项目的启动目标是否为正确的Windows平台(如Windows (框架: net8.0-windows10.0.19041.0)),右键项目→属性→应用程序,确认目标框架匹配已安装的Windows SDK版本,且启用了Windows应用SDK(.NET 8+版本需勾选)。清理重建解决方案
执行Clean Solution后再Rebuild Solution,手动删除MAUI项目下的bin和obj文件夹,彻底清理编译缓存后重新编译运行。验证BlazorWebView配置
打开MAUI项目的MainPage.xaml,确认BlazorWebView的HostPage指向wwwroot/index.html,且RootComponents正确注册了共享类库的Main组件:<BlazorWebView HostPage="wwwroot/index.html"> <BlazorWebView.RootComponents> <RootComponent Selector="#app" ComponentType="{x:Type shared:Main}" /> </BlazorWebView.RootComponents> </BlazorWebView>同时检查
wwwroot/index.html中存在#app容器,且blazor.webview.js引用路径正确:<div id="app">Loading...</div> <script src="_framework/blazor.webview.js"></script>启用调试日志排查加载细节
在MAUI项目的Program.cs中添加日志过滤配置,输出BlazorWebView的Debug级日志:builder.Logging.AddFilter("Microsoft.AspNetCore.Components.WebView", LogLevel.Debug);运行应用后查看输出窗口,定位是否存在组件加载失败、资源缺失等隐性错误。
检查Visual Studio与SDK组件
打开Visual Studio安装器,确认已安装完整的.NET MAUI开发工具和对应版本的Windows应用SDK,若版本不匹配,更新SDK或调整项目目标框架。测试基础MAUI Blazor项目
创建一个不带Web SSR的空MAUI Blazor Hybrid项目,运行Windows目标验证是否正常显示。若正常,说明原模板的类库引用或Web SSR配置存在冲突,尝试重新添加共享类库引用。排查Windows应用权限
右键MAUI项目→属性→Windows应用程序→功能,确认勾选Internet (客户端)权限;尝试以管理员身份运行Visual Studio,排除权限限制导致的资源加载失败。
内容的提问来源于stack exchange,提问作者M. Ali Iftikhar

